JapaneseCalendar Класс

Определение

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

System.Globalization

Сборки:

mscorlib.dll, System.Globalization.Calendars.dll

Сборка:

System.Runtime.dll

Сборка:

System.Globalization.Calendars.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

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

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

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

Object

Calendar

JapaneseCalendar

Атрибуты

SerializableAttribute ComVisibleAttribute

Комментарии

Японский календарь, который также известен как календарь Wareki, работает точно так же, как григорианский календарь, за исключением того, что год и эра отличаются.

Примечание

Сведения об использовании JapaneseCalendar класса и других классов календаря в .NET см. в статье "Работа с календарями".

Японский календарь признает одну эпоху для правления каждого императора. Две последние эпохи являются эрой Heisei, начиная с григорианского календарного года 1989 года, и эры Рейва, начиная с григорианского календарного года 2019 года. Название эры обычно отображается до года. Например, григорианский календарный год 2001 — японский календарный год Heisei 13. Обратите внимание, что первый год эпохи называется "Ганнен". Таким образом, григорианский календарный год 1989 года был японским календарным годом Heisei Gannen. По умолчанию операции форматирования с указанными строками формата даты и времени, такими как "D", "F" и "Y", выводить Ганнен вместо "1" в результирующей строке.

Важно!

Эры в японских календарях основаны на периодах царствования императоров. Таким образом, ожидается наступление новой эры. Например, 1 мая 2019 года в 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)	8 сентября 1868 г. по 29 июля 1912 г.

Этот класс обрабатывает даты с 8 сентября года Meiji 1 (в григорианском календаре, 8 сентября 1868 г.). Хотя японский календарь был переключен с лунного календаря на солнечный календарь в год Meiji 6 (1873 григорианского календаря), эта реализация основана только на солнечном календаре.

Високосные годы в японском календаре соответствуют тем же високосным годам григорианского календаря. Високосный год в григорианском календаре определяется как григорианский год, который равномерно делится на четыре, за исключением случаев, если он делится на 100. Тем не менее, григорианские годы, которые делится на 400 лет високосные годы. Общий год имеет 365 дней, и високосный год имеет 366 дней.

Японский календарь имеет 12 месяцев с 28 по 31 день каждый:

Значение GetMonth	Месяц	Английский	Дни в общих годах	Дни високосных лет
1	1月 (Ichigatsu)	Январь	31	31
2	2月 (Нигатсу)	Февраль	28	29
3	3月 (Сангатсу)	Март	31	31
4	4月 (Шигатсу)	Апрель	30	30
5	5月 (Gogatsu)	Май	31	31
6	6月 (Rokugatsu)	Июнь	30	30
7	7月 (Шичигатсу)	Июль	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 г. в григорианском календаре эквивалентен первому дню Ichigatsu в году 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)

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

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