JapaneseCalendar Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет японский календарь.
public ref class JapaneseCalendar : System::Globalization::Calendarpublic class JapaneseCalendar : System.Globalization.Calendar[System.Serializable]
public class JapaneseCalendar : System.Globalization.Calendar[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class JapaneseCalendar : System.Globalization.Calendartype JapaneseCalendar = class
inherit Calendar[<System.Serializable>]
type JapaneseCalendar = class
inherit Calendar[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type JapaneseCalendar = class
inherit CalendarPublic Class JapaneseCalendar
Inherits Calendar- Наследование
- Атрибуты
Комментарии
Японский календарь, также известный как календарь Wareki, работает точно так же, как григорианский календарь, за исключением того, что год и эра отличаются.
Примечание
Сведения об использовании JapaneseCalendar класса и других классов календарей в .NET см. в статье Работа с календарями.
Японский календарь признает одну эпоху для правления каждого императора. Две последние эпохи — эра Хэйсэй, начиная с григорианского календарного года 1989 года, и эра Рейва, начиная с григорианского календарного года 2019 года. Название эры обычно отображается до года. Например, григорианский календарный год 2001 является японским календарным годом Heisei 13. Обратите внимание, что первый год эры называется "Ганнен". Таким образом, григорианский календарный год 1989 года был японским календарным годом Хэйсэй Ганнен. По умолчанию операции форматирования с указанными строками формата даты и времени, такие как "D", "F" и "Y", выводятся в результирующей строке ганнен, а не "1".
Важно!
Эры в японских календарях основаны на периодах царствования императоров. Таким образом, ожидается наступление новой эры. Например, 1 мая 2019 года в JapaneseCalendar и JapaneseLunisolarCalendar отмечено как начало эры Рэйва. Изменение эры затрагивает все приложения, использующие эти календари. Дополнительные сведения и определение того, затронуты ли ваши приложения, см. в статье Обработка новой эры в японском календаре в .NET. Сведения о тестировании приложений в системах Windows для обеспечения их готовности к изменению эпохи см. в статье Подготовка приложения к изменению японской эры. Сведения о функциях в .NET, поддерживающих календари с несколькими эрами, а также рекомендации по работе с календарями, поддерживающими несколько эпох, см. в статье Работа с эрами.
Этот класс присваивает числа эрам следующим образом:
| Значение GetEra | Имя эры | Аббревиатура эры | Григорианские даты |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | С 1 мая 2019 г. по настоящее время |
| 4 | 平成 (Хэйсэй) | 平 (H, h) | С 8 января 1989 г. по 30 апреля 2019 г. |
| 3 | 昭和 (Showa) | 昭 (S, s) | 25 декабря 1926 г. по 7 января 1989 г. |
| 2 | 大正 (Taisho) | 大 (T, t) | 30 июля 1912 г. по 24 декабря 1926 г. |
| 1 | 明治 (Мэйдзи) | 明 (M, m) | 8 сентября 1868 г. по 29 июля 1912 г. |
Этот класс обрабатывает даты с 8 сентября в году Мэйдзи 1 (по григорианскому календарю, 8 сентября 1868 года). Хотя японский календарь был переключен с лунного календаря на солнечный в год Мэйдзи 6 (1873 григорианского календаря), эта реализация основана только на солнечном календаре.
Високосные годы в японском календаре соответствуют тем же високосным годам григорианского календаря. Високосный год по григорианскому календарю определяется как григорианский год, который равномерно делится на четыре, за исключением случаев, когда он делится на 100. Однако григорианские годы, которые делится на 400, являются високосными годами. Общий год имеет 365 дней, а високосный год имеет 366 дней.
Японский календарь содержит 12 месяцев с 28 по 31 день каждый:
| Значение GetMonth | Месяц | Английский | Дни в общих годах | Дни в високосных годах |
|---|---|---|---|---|
| 1 | 1月 (Итигацу) | Январь | 31 | 31 |
| 2 | 2月 (Нигацу) | Февраль | 28 | 29 |
| 3 | 3月 (Сангацу) | Март | 31 | 31 |
| 4 | 4月 (Шигацу) | Апрель | 30 | 30 |
| 5 | 5月 (Гогацу) | Май | 31 | 31 |
| 6 | 6月 (Rokugatsu) | Июнь | 30 | 30 |
| 7 | 7月 (Shichigatsu) | Июль | 31 | 31 |
| 8 | 8月 (Хатигацу) | Август | 31 | 31 |
| 9 | 9月 (Kugatsu) | Сентябрь | 30 | 30 |
| 10 | 10月 (Juugatsu) | Октябрь | 31 | 31 |
| 11 | 11月 (Juuichigatsu) | Ноябрь | 30 | 30 |
| 12 | 12月 (Juunigatsu) | Декабрь | 31 | 31 |
Nigatsu, что эквивалентно григорианскому календарю февраля, имеет 29 дней в високосные годы и 28 в обычные годы.
Дата 1 января 2001 г. н.э. в григорианском календаре эквивалентна первому дню Итигатсу в году Heisei 13 в японском календаре.
JapaneseCalendar Если является текущим календарем японской культуры, DateTime.Parse распознает сокращения эры перед годом. Аббревиатура — это однозначная аббревиатура латинского алфавита без учета регистра или однозначная аббревиатура кандзи. DateTime.Parse также распознает "1" или Ганнен (元年) как первый год эпохи.
Каждый CultureInfo объект поддерживает набор календарей. Свойство Calendar возвращает календарь по умолчанию для языка и региональных параметров, а свойство возвращает массив, содержащий все календари, поддерживаемые языком и OptionalCalendars региональными параметрами. Чтобы изменить календарь, используемый CultureInfo, присвойте свойству DateTimeFormatInfo.Calendar новое Calendarзначение .
Конструкторы
| JapaneseCalendar() |
Инициализирует новый экземпляр класса JapaneseCalendar. |
Поля
| CurrentEra |
Представляет текущую эру для текущего календаря. Значение этого поля равно 0. (Унаследовано от Calendar) |
Свойства
| AlgorithmType |
Возвращает значение, показывающее, является ли текущий календарь солнечным, лунным или сочетанием и того, и другого. |
| AlgorithmType |
Возвращает значение, показывающее, является ли текущий календарь солнечным, лунным или сочетанием и того, и другого. (Унаследовано от Calendar) |
| DaysInYearBeforeMinSupportedYear |
Получает число дней в году, который предшествует году, указанному свойством MinSupportedDateTime. (Унаследовано от Calendar) |
| Eras |
Возвращает список эр в классе JapaneseCalendar. |
| IsReadOnly |
Возвращает значение, указывающее, является ли объект Calendar доступным только для чтения. (Унаследовано от Calendar) |
| MaxSupportedDateTime |
Возвращает самые последние дату и время, поддерживаемые текущим объектом JapaneseCalendar. |
| MaxSupportedDateTime |
Возвращает самые последние дату и время, поддерживаемые этим объектом Calendar. (Унаследовано от Calendar) |
| MinSupportedDateTime |
Возвращает самые ранние дату и время, поддерживаемые текущим объектом JapaneseCalendar. |
| MinSupportedDateTime |
Возвращает самые ранние дату и время, поддерживаемые этим объектом Calendar. (Унаследовано от Calendar) |
| TwoDigitYearMax |
Возвращает или задает последний год в диапазоне ста лет, для которого существует двузначное представление года. |
Методы
| AddDays(DateTime, Int32) |
Возвращает DateTime как заданное число дней из заданного объекта DateTime. (Унаследовано от Calendar) |
| AddHours(DateTime, Int32) |
Возвращает DateTime как заданное число часов из заданного объекта DateTime. (Унаследовано от Calendar) |
| AddMilliseconds(DateTime, Double) |
Возвращает DateTime как заданное число миллисекунд из заданного объекта DateTime. (Унаследовано от Calendar) |
| AddMinutes(DateTime, Int32) |
Возвращает DateTime как заданное число минут из заданного объекта DateTime. (Унаследовано от Calendar) |
| AddMonths(DateTime, Int32) |
Возвращает значение типа DateTime, отличающееся от заданного значения типа DateTime на заданное число месяцев. |
| AddSeconds(DateTime, Int32) |
Возвращает DateTime как заданное число секунд из заданного объекта DateTime. (Унаследовано от Calendar) |
| AddWeeks(DateTime, Int32) |
Возвращает DateTime как заданное число недель из заданного объекта DateTime. (Унаследовано от Calendar) |
| AddYears(DateTime, Int32) |
Возвращает значение типа DateTime, отстающее от заданного значения типа DateTime на заданное число лет. |
| Clone() |
Создает новый объект, являющийся копией текущего объекта Calendar. (Унаследовано от Calendar) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetDayOfMonth(DateTime) |
Возвращает день месяца из заданной структуры DateTime. |
| GetDayOfWeek(DateTime) |
Возвращает день недели из заданной структуры DateTime. |
| GetDayOfYear(DateTime) |
Возвращает день года в заданном параметре DateTime. |
| GetDaysInMonth(Int32, Int32) |
Возвращает число дней в указанном месяце указанных года текущей эры. (Унаследовано от Calendar) |
| GetDaysInMonth(Int32, Int32, Int32) |
Возвращает число дней в указанном месяце указанных года и эры. |
| GetDaysInYear(Int32) |
Возвращает число дней в указанном году текущей эры. (Унаследовано от Calendar) |
| GetDaysInYear(Int32, Int32) |
Возвращает число дней в указанном году указанной эры. |
| GetEra(DateTime) |
Возвращает значение эры из заданного объекта DateTime. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetHour(DateTime) |
Возвращает значение часов в заданном DateTime. (Унаследовано от Calendar) |
| GetLeapMonth(Int32) |
Вычисляет високосный месяц для заданного года. (Унаследовано от Calendar) |
| GetLeapMonth(Int32, Int32) |
Вычисляет високосный месяц для заданных года и эры. |
| GetLeapMonth(Int32, Int32) |
Вычисляет високосный месяц для заданных года и эры. (Унаследовано от Calendar) |
| GetMilliseconds(DateTime) |
Возвращает значение миллисекунд в заданном DateTime. (Унаследовано от Calendar) |
| GetMinute(DateTime) |
Возвращает значение минут в заданном DateTime. (Унаследовано от Calendar) |
| GetMonth(DateTime) |
Возвращает месяц в заданном типе DateTime. |
| GetMonthsInYear(Int32) |
Возвращает число месяцев в указанном году текущей эры. (Унаследовано от Calendar) |
| GetMonthsInYear(Int32, Int32) |
Возвращает число месяцев в указанном году указанной эры. |
| GetSecond(DateTime) |
Возвращает значение секунд в заданном DateTime. (Унаследовано от Calendar) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Возвращает неделю года, к которой относится дата в заданном типе DateTime. |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Возвращает неделю года, к которой относится дата в заданном значении DateTime. (Унаследовано от Calendar) |
| GetYear(DateTime) |
Возвращает значение года в заданном DateTime. |
| IsLeapDay(Int32, Int32, Int32) |
Определяет, является ли указанная дата текущей эры високосным днем. (Унаследовано от Calendar) |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Определяет, является ли указанная дата указанной эры високосным днем. |
| IsLeapMonth(Int32, Int32) |
Определяет, является ли указанный месяц указанного года текущей эры високосным месяцем. (Унаследовано от Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Определяет, является ли указанный месяц указанного года указанной эры високосным месяцем. |
| IsLeapYear(Int32) |
Определяет, является ли указанный год текущей эры високосным годом. (Унаследовано от Calendar) |
| IsLeapYear(Int32, Int32) |
Определяет, является ли указанный год указанной эры високосным годом. |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Возвращает DateTime с заданными значениями даты и времени текущей эры. (Унаследовано от Calendar) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Возвращает DateTime с заданными значениями даты и времени в указанной эре. |
| ToFourDigitYear(Int32) |
Преобразует заданный год в четырехзначное представление с использованием свойства TwoDigitYearMax для определения века. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
