JapaneseCalendar Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет японский календарь.
public ref class JapaneseCalendar : System::Globalization::Calendar
public 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.Calendar
type JapaneseCalendar = class
inherit Calendar
[<System.Serializable>]
type JapaneseCalendar = class
inherit Calendar
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type JapaneseCalendar = class
inherit Calendar
Public Class JapaneseCalendar
Inherits Calendar
- Наследование
- Атрибуты
Комментарии
Японский календарь, который также известен как календарь Wareki, работает точно так же, как григорианский календарь, за исключением того, что год и эра отличаются.
Note
Сведения об использовании JapaneseCalendar класса и других классов календаря в .NET см. в разделе "Работа с календарями".
Японский календарь признает одну эпоху для правления каждого императора. Две последние эпохи являются эрой Heisei, начиная с григорианского календарного года 1989 года, и эры Reiwa, начиная с григорианского календарного года 2019 года. Имя эпохи обычно отображается до года. Например, григорианский календарный год 2001 года является японским календарным годом Heisei 13. Обратите внимание, что первый год эпохи называется "Ганнен". Поэтому григорианский календарный год 1989 года был японским календарным годом Heisei Gannen. По умолчанию операции форматирования с заданными строками формата даты и времени, например "D", "F" и "Y", выходные данные Gannen, а не "1" в результирующей строке.
Important
Эры в японских календарях основаны на царствии императора и поэтому, как ожидается, изменятся. Например, 1 мая 2019 г. отмечено начало эпохи Reiwa в JapaneseCalendar и JapaneseLunisolarCalendar. Такое изменение эпохи влияет на все приложения, использующие эти календари. Для получения дополнительной информации и определения влияния на ваши приложения см. статью Обработка новой эпохи в японском календаре в .NET. Сведения о тестировании ваших приложений на системах Windows для обеспечения их готовности к изменению эпохи см. в разделе Подготовка приложения к изменению японской эпохи. Функции в .NET, поддерживающие календари с несколькими эрами, и рекомендации по работе с календарями, поддерживающими несколько эпох, см. в разделе Работа с эрами.
Этот класс назначает числа эрам следующим образом:
| Значение GetEra | Имя эры | Аббревиатура эры | Грегорианские даты |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | 1 мая 2019 г. |
| 4 | 平成 (Heisei) | 平 (H, h) | 8 января 1989 г. до 30 апреля 2019 г. |
| 3 | 昭和 (Showa) | 昭 (S, s) | 25 декабря 1926 по 7 января 1989 г. |
| 2 | 大正 (Тайшо) | 大 (T, t) | 30 июля 1912 г. –24 декабря 1926 г. |
| 1 | 明治 (Meiji) | 明 (M, m) | 23 октября 1868 г. до 29 июля 1912 г. |
Этот класс обрабатывает даты с 23 октября в году Meiji 1 (в григорианском календаре, 23 октября 1868 г.). Хотя японский календарь был переключен с лунного календаря на солнечный календарь в год Meiji 6 (1873 григорианского календаря), эта реализация основана только на солнечном календаре.
Високосные годы в японском календаре соответствуют тем же викосным годам в григорианском календаре. Високосный год в григорианском календаре определяется как григорианский год, который равномерно делится на четыре, за исключением того, если он делится на 100. Тем не менее, григорианские годы, которые делятся на 400 лет високосные годы. Общий год имеет 365 дней, и високосный год имеет 366 дней.
Японский календарь имеет 12 месяцев с 28 до 31 дней каждый:
| Значение GetMonth | месяц | English | Дни в общих годах | Дни в вискочие годы |
|---|---|---|---|---|
| 1 | 1月 (Ichigatsu) | Январь | 31 | 31 |
| 2 | 2月 (Nigatsu) | февраль | 28 | 29 |
| 3 | 3月 (Сангатсу) | Март | 31 | 31 |
| 4 | 4月 (Шигатсу) | Апрель | 30 | 30 |
| 5 | 5月 (Gogatsu) | май | 31 | 31 |
| 6 | 6月 (Rokugatsu) | июня | 30 | 30 |
| 7 | 7月 (Shichigatsu) | Июль | 31 | 31 |
| 8 | 8月 (Hachigatsu) | август | 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 |
Возвращает значение, указывающее, является ли текущий календарь солнечным, лунным или сочетанием обоих. |
| DaysInYearBeforeMinSupportedYear |
Возвращает количество дней в году, которое предшествует году, заданному свойством MinSupportedDateTime . (Унаследовано от Calendar) |
| Eras |
Возвращает список эпох в элементе JapaneseCalendar. |
| IsReadOnly |
Возвращает значение, указывающее, доступен ли этот Calendar объект только для чтения. (Унаследовано от Calendar) |
| MaxSupportedDateTime |
Возвращает последнюю дату и время, поддерживаемую текущим JapaneseCalendar объектом. |
| MinSupportedDateTime |
Возвращает самые ранние даты и времени, поддерживаемые текущим JapaneseCalendar объектом. |
| TwoDigitYearMax |
Возвращает или задает последний год 100-летнего диапазона, который может быть представлен 2-цифрным годом. |
Методы
| Имя | Описание |
|---|---|
| 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, Int32) |
Возвращает количество дней в указанном месяце в указанном году в указанной эре. |
| GetDaysInMonth(Int32, Int32) |
Возвращает количество дней в указанном месяце и году текущей эпохи. (Унаследовано от Calendar) |
| GetDaysInYear(Int32, Int32) |
Возвращает количество дней в указанном году в указанной эре. |
| GetDaysInYear(Int32) |
Возвращает количество дней в указанном году текущей эпохи. (Унаследовано от Calendar) |
| GetEra(DateTime) |
Возвращает эру в указанной DateTime. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetHour(DateTime) |
Возвращает значение часов в указанном DateTime. (Унаследовано от Calendar) |
| GetLeapMonth(Int32, Int32) |
Вычисляет високосный месяц за указанный год и эру. |
| GetLeapMonth(Int32) |
Вычисляет високосный месяц за указанный год. (Унаследовано от Calendar) |
| GetMilliseconds(DateTime) |
Возвращает значение миллисекунда в указанном DateTime. (Унаследовано от Calendar) |
| GetMinute(DateTime) |
Возвращает значение минут в указанном DateTime. (Унаследовано от Calendar) |
| GetMonth(DateTime) |
Возвращает месяц в указанном DateTime. |
| GetMonthsInYear(Int32, Int32) |
Возвращает количество месяцев в указанном году в указанной эре. |
| GetMonthsInYear(Int32) |
Возвращает количество месяцев в указанном году в текущей эре. (Унаследовано от Calendar) |
| 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, Int32) |
Определяет, является ли указанная дата в указанной эре високосным днем. |
| IsLeapDay(Int32, Int32, Int32) |
Определяет, является ли указанная дата в текущей эре високосным днем. (Унаследовано от Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Определяет, является ли указанный месяц указанным годом в указанной эре високосным месяцем. |
| IsLeapMonth(Int32, Int32) |
Определяет, является ли указанный месяц в указанном году в текущей эре високосным месяцем. (Унаследовано от Calendar) |
| IsLeapYear(Int32, Int32) |
Определяет, является ли указанный год в указанной эре високосным годом. |
| IsLeapYear(Int32) |
Определяет, является ли указанный год в текущей эре високосным годом. (Унаследовано от Calendar) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
DateTime Возвращает значение указанной даты и времени в указанной эре. |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Возвращает значение указанной DateTime даты и времени в текущей эре. (Унаследовано от Calendar) |
| ToFourDigitYear(Int32) |
Преобразует указанный год в четырехзначный год с помощью TwoDigitYearMax свойства для определения соответствующего века. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |