JapaneseCalendar Класс

Определение

Пространство имен:

System.Globalization

Сборка:

System.Runtime.dll

Исходный код:

JapaneseCalendar.cs

Представляет японский календарь.

public ref class JapaneseCalendar : System::Globalization::Calendar

public class JapaneseCalendar : System.Globalization.Calendar

type JapaneseCalendar = class
    inherit Calendar

Public Class JapaneseCalendar
Inherits Calendar

Наследование

Object

Calendar

JapaneseCalendar

Комментарии

Японский календарь, также известный как календарь 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	Возвращает значение, показывающее, является ли текущий календарь солнечным, лунным или сочетанием и того, и другого.
DaysInYearBeforeMinSupportedYear	Получает число дней в году, который предшествует году, указанному свойством MinSupportedDateTime. (Унаследовано от Calendar)
Eras	Возвращает список эр в классе JapaneseCalendar.
IsReadOnly	Возвращает значение, указывающее, является ли объект Calendar доступным только для чтения. (Унаследовано от Calendar)
MaxSupportedDateTime	Возвращает самые последние дату и время, поддерживаемые текущим объектом JapaneseCalendar.
MinSupportedDateTime	Возвращает самые ранние дату и время, поддерживаемые текущим объектом JapaneseCalendar.
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)	Вычисляет високосный месяц для заданных года и эры.
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.
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)

См. также раздел

• Calendar
• GregorianCalendar
• Calendar
• OptionalCalendars
• Работа с календарями