JapaneseCalendar JapaneseCalendar JapaneseCalendar JapaneseCalendar Class

Определение

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

public ref class JapaneseCalendar : System::Globalization::Calendar
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class JapaneseCalendar : System.Globalization.Calendar
type JapaneseCalendar = class
    inherit Calendar
Public Class JapaneseCalendar
Inherits Calendar
Наследование
JapaneseCalendarJapaneseCalendarJapaneseCalendarJapaneseCalendar
Атрибуты

Комментарии

Японского календаря, который также называется Wareki календаря, работает так же, как григорианского календаря, за исключением того, что отличаются года и эры.The Japanese calendar, which is also known as the Wareki calendar, works exactly like the Gregorian calendar, except that the year and era are different.

Примечание

Дополнительные сведения об использовании JapaneseCalendar класса, а другой календарь на классы в .NET, см. в разделе работа с календарями.For information about using the JapaneseCalendar class and the other calendar classes in .NET, see Working with Calendars.

Одна эра для каждого императора reign японский календарь.The Japanese calendar recognizes one era for every emperor's reign. Две последние эры — эры Хэйсэй, начиная с год по григорианскому календарю 1989 г. и Reiwa эру, начиная с год по григорианскому календарю 2019 г.The two most recent eras are the Heisei era, beginning in the Gregorian calendar year 1989, and the Reiwa era, beginning in the Gregorian calendar year 2019. Название эры обычно отображается до года.The era name is typically displayed before the year. Например 2001 года григорианского календаря — Японский Хэйсэй календарного года.For example, the Gregorian calendar year 2001 is the Japanese calendar year Heisei 13. Обратите внимание, что первый год эры называется «Ганнэн».Note that the first year of an era is called "Gannen." Таким образом год по григорианскому календарю 1989 был японский Хэйсэй Ганнэн календарного года.Therefore, the Gregorian calendar year 1989 was the Japanese calendar year Heisei Gannen. По умолчанию форматирование операций с указанной даты и времени строки формата, например «D», «F» и «Y», выходные данные Ганнэн, а не «1» в результирующей строке.By default, formatting operations with specified date and time format strings, such as "D", "F", and "Y", output Gannen rather than "1" in the result string.

Важно!

Эры в японских календарях основаны на периодах царствования императоров. Таким образом, ожидается наступление новой эры.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Например, 1 мая 2019 года в JapaneseCalendar и JapaneseLunisolarCalendar отмечено как начало эры Рэйва.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Изменение эры затрагивает все приложения, использующие эти календари.Such a change of era affects all applications that use these calendars. Из раздела Обработка новой эры по японскому календарю в .NET можно почерпнуть дополнительные сведения, а также узнать, затронуты ли ваши приложения этим изменением.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Сведения о тестировании приложений в системах Windows для обеспечения их готовности к работе в новой эре см. в разделе Подготовка приложения к изменению эры по японскому календарю.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Сведения о функциях в .NET, которые поддерживают календарь с несколькими эрами, и рекомендации по использованию таких календарей см. в разделе о работе с эрами.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Этот класс настраивает числа для эры следующим образом:This class assigns numbers to the eras as follows:

Значение GetEraGetEra value Имя эрыEra Name Аббревиатура эрыEra Abbreviation Даты григорианского календаряGregorian Dates
55 令和 (Reiwa)令和 (Reiwa) 令和 (R, r)令和 (R, r) 1 мая 2019 г. для представленияMay 1, 2019 to present
44 平成 (Хэйсэй)平成 (Heisei) 平 (H, h)平 (H, h) 8 января 1989 30 апреля 2019 г.January 8, 1989 to April 30, 2019
33 昭和 (Шова)昭和 (Showa) 昭 ("S", "s")昭 (S, s) 25 декабрь, 1926 г. — 7 января 1989 г.December 25, 1926 to January 7, 1989
22 大正 (Taisho)大正 (Taisho) 大 ("T", "t")大 (T, t) 30 июля 1912 24 декабря, 1926 г. —July 30, 1912 to December 24, 1926
11 明治 (Meiji)明治 (Meiji) 明 ("M", "m")明 (M, m) 8 сентября 1868 29 июля 1912September 8, 1868 to July 29, 1912

Этот класс обрабатывает даты с 8 сентября 2008 года Мэйдзи (по григорианскому календарю, 8 сентября 1868).This class handles dates from September 8 in the year Meiji 1 (in the Gregorian calendar, September 8, 1868). Несмотря на то, что японского календаря была переключена с лунный календарь солнечный календарь в году Мэйдзи (1873 г. по григорианскому календарю), эта реализация зависит только солнечный календарь.Although the Japanese calendar was switched from a lunar calendar to a solar calendar in the year Meiji 6 (1873 of the Gregorian calendar), this implementation is based on the solar calendar only.

Високосные годы по японскому календарю соответствуют високосным годам по григорианскому календарю.Leap years in the Japanese calendar correspond to the same leap years in the Gregorian calendar. Високосный год по григорианскому календарю определяется как год, делится на 4, за исключением случаев, если он делится на 100.A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. Тем не менее года по григорианскому календарю, делится на 400, год является високосным.However, Gregorian years that are divisible by 400 are leap years. Распространенные году 365 дней, високосным годом 366 дней.A common year has 365 days and a leap year has 366 days.

Японский календарь содержит 12 месяцев с 28 до 31 дня:The Japanese calendar has 12 months with 28 to 31 days each:

Значение GetMonthGetMonth value Месяц.Month АнглийскийEnglish Дней в обычных годахDays in common years Дней в годы leapDays in leap years
11 1月 (Итигацу)1月 (Ichigatsu) ЯнварьJanuary 3131 3131
22 2月 (нигацу)2月 (Nigatsu) ФевральFebruary 2828 2929
33 3月 (Sangatsu)3月 (Sangatsu) МартаMarch 3131 3131
44 4月 (сигасу)4月 (Shigatsu) АпрельApril 3030 3030
55 5月 (Гогацу)5月 (Gogatsu) МожетMay 3131 3131
66 6月 (Рокугацу)6月 (Rokugatsu) ИюньJune 3030 3030
77 7月 (Ситигацу)7月 (Shichigatsu) ИюльJuly 3131 3131
88 8月 (Хатигацу)8月 (Hachigatsu) АвгустAugust 3131 3131
99 9月 (Кугацу)9月 (Kugatsu) СентябрьSeptember 3030 3030
1010 10月 (дзюгацу)10月 (Juugatsu) ОктябрьOctober 3131 3131
1111 11月 (Дзюитигацу)11月 (Juuichigatsu) НоябрьNovember 3030 3030
1212 12月 (Дзюнигацу)12月 (Juunigatsu) ДекабрьDecember 3131 3131

Нигацу, что эквивалентно григорианский календарь месяца февраля, имеет 29 дней високосного года и 28 обычные годы.Nigatsu, which is equivalent to the Gregorian calendar month of February, has 29 days during leap years and 28 during common years.

Дату 1 января 2001 г. н. э.The date January 1, 2001 A.D. по григорианскому календарю соответствует первому дню месяца итигацу года эры Хэйсэй по японскому календарю.in the Gregorian calendar is equivalent to the first day of Ichigatsu in the year Heisei 13 in the Japanese calendar.

Если JapaneseCalendar является текущим календарем для японского языка и региональных параметров, DateTime.Parse распознает сокращение названия эры перед года.If the JapaneseCalendar is the current calendar of the Japanese culture, DateTime.Parse recognizes the era abbreviations in front of the year. Сокращение может без учета регистра латинского алфавита одиночные либо канджи одного символа.The abbreviation is either the single-character case-insensitive Latin alphabet abbreviation or the single-character Kanji abbreviation. XRef:System.DateTime.Parse%2A?displayProperty=nameWithType > также распознает «1» или Ганнэн (元年) в качестве первого года эры.xref:System.DateTime.Parse%2A?displayProperty=nameWithType> also recognizes either "1" or Gannen (元年) as the first year of an era.

Каждый CultureInfo объект поддерживает несколько календарей.Each CultureInfo object supports a set of calendars. Calendar Свойство возвращает календаря по умолчанию для языка и региональных параметров и OptionalCalendars свойство возвращает массив, содержащий все календари, поддерживаемые языком и региональными параметрами.The Calendar property returns the default calendar for the culture, and the OptionalCalendars property returns an array containing all the calendars supported by the culture. Чтобы изменить календарь, используемый CultureInfo, задайте DateTimeFormatInfo.Calendar свойство в новый Calendar.To change the calendar used by a CultureInfo, set the DateTimeFormatInfo.Calendar property to a new Calendar.

Конструкторы

JapaneseCalendar() JapaneseCalendar() JapaneseCalendar() JapaneseCalendar()

Инициализирует новый экземпляр класса JapaneseCalendar.Initializes a new instance of the JapaneseCalendar class.

Свойства

AlgorithmType AlgorithmType AlgorithmType AlgorithmType

Возвращает значение, показывающее, является ли текущий календарь солнечным, лунным или сочетанием и того, и другого.Gets a value that indicates whether the current calendar is solar-based, lunar-based, or a combination of both.

DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear

Получает число дней в году, который предшествует году, указанному свойством MinSupportedDateTime.Gets the number of days in the year that precedes the year that is specified by the MinSupportedDateTime property.

(Inherited from Calendar)
Eras Eras Eras Eras

Возвращает список эр в классе JapaneseCalendar.Gets the list of eras in the JapaneseCalendar.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Возвращает значение, указывающее, является ли объект Calendar доступным только для чтения.Gets a value indicating whether this Calendar object is read-only.

(Inherited from Calendar)
MaxSupportedDateTime MaxSupportedDateTime MaxSupportedDateTime MaxSupportedDateTime

Возвращает самые последние дату и время, поддерживаемые текущим объектом JapaneseCalendar.Gets the latest date and time supported by the current JapaneseCalendar object.

MinSupportedDateTime MinSupportedDateTime MinSupportedDateTime MinSupportedDateTime

Возвращает самые ранние дату и время, поддерживаемые текущим объектом JapaneseCalendar.Gets the earliest date and time supported by the current JapaneseCalendar object.

TwoDigitYearMax TwoDigitYearMax TwoDigitYearMax TwoDigitYearMax

Возвращает или задает последний год в диапазоне ста лет, для которого существует двузначное представление года.Gets or sets the last year of a 100-year range that can be represented by a 2-digit year.

Методы

AddDays(DateTime, Int32) AddDays(DateTime, Int32) AddDays(DateTime, Int32) AddDays(DateTime, Int32)

Возвращает DateTime как заданное число дней из заданного объекта DateTime.Returns a DateTime that is the specified number of days away from the specified DateTime.

(Inherited from Calendar)
AddHours(DateTime, Int32) AddHours(DateTime, Int32) AddHours(DateTime, Int32) AddHours(DateTime, Int32)

Возвращает DateTime как заданное число часов из заданного объекта DateTime.Returns a DateTime that is the specified number of hours away from the specified DateTime.

(Inherited from Calendar)
AddMilliseconds(DateTime, Double) AddMilliseconds(DateTime, Double) AddMilliseconds(DateTime, Double) AddMilliseconds(DateTime, Double)

Возвращает DateTime как заданное число миллисекунд из заданного объекта DateTime.Returns a DateTime that is the specified number of milliseconds away from the specified DateTime.

(Inherited from Calendar)
AddMinutes(DateTime, Int32) AddMinutes(DateTime, Int32) AddMinutes(DateTime, Int32) AddMinutes(DateTime, Int32)

Возвращает DateTime как заданное число минут из заданного объекта DateTime.Returns a DateTime that is the specified number of minutes away from the specified DateTime.

(Inherited from Calendar)
AddMonths(DateTime, Int32) AddMonths(DateTime, Int32) AddMonths(DateTime, Int32) AddMonths(DateTime, Int32)

Возвращает значение типа DateTime, отличающееся от заданного значения типа DateTime на заданное число месяцев.Returns a DateTime that is the specified number of months away from the specified DateTime.

AddSeconds(DateTime, Int32) AddSeconds(DateTime, Int32) AddSeconds(DateTime, Int32) AddSeconds(DateTime, Int32)

Возвращает DateTime как заданное число секунд из заданного объекта DateTime.Returns a DateTime that is the specified number of seconds away from the specified DateTime.

(Inherited from Calendar)
AddWeeks(DateTime, Int32) AddWeeks(DateTime, Int32) AddWeeks(DateTime, Int32) AddWeeks(DateTime, Int32)

Возвращает DateTime как заданное число недель из заданного объекта DateTime.Returns a DateTime that is the specified number of weeks away from the specified DateTime.

(Inherited from Calendar)
AddYears(DateTime, Int32) AddYears(DateTime, Int32) AddYears(DateTime, Int32) AddYears(DateTime, Int32)

Возвращает значение типа DateTime, отстающее от заданного значения типа DateTime на заданное число лет.Returns a DateTime that is the specified number of years away from the specified DateTime.

Clone() Clone() Clone() Clone()

Создает новый объект, являющийся копией текущего объекта Calendar.Creates a new object that is a copy of the current Calendar object.

(Inherited from Calendar)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDayOfMonth(DateTime) GetDayOfMonth(DateTime) GetDayOfMonth(DateTime) GetDayOfMonth(DateTime)

Возвращает день месяца из заданной структуры DateTime.Returns the day of the month in the specified DateTime.

GetDayOfWeek(DateTime) GetDayOfWeek(DateTime) GetDayOfWeek(DateTime) GetDayOfWeek(DateTime)

Возвращает день недели из заданной структуры DateTime.Returns the day of the week in the specified DateTime.

GetDayOfYear(DateTime) GetDayOfYear(DateTime) GetDayOfYear(DateTime) GetDayOfYear(DateTime)

Возвращает день года в заданном параметре DateTime.Returns the day of the year in the specified DateTime.

GetDaysInMonth(Int32, Int32) GetDaysInMonth(Int32, Int32) GetDaysInMonth(Int32, Int32) GetDaysInMonth(Int32, Int32)

Возвращает число дней в указанном месяце указанных года текущей эры.Returns the number of days in the specified month and year of the current era.

(Inherited from Calendar)
GetDaysInMonth(Int32, Int32, Int32) GetDaysInMonth(Int32, Int32, Int32) GetDaysInMonth(Int32, Int32, Int32) GetDaysInMonth(Int32, Int32, Int32)

Возвращает число дней в указанном месяце указанных года и эры.Returns the number of days in the specified month in the specified year in the specified era.

GetDaysInYear(Int32) GetDaysInYear(Int32) GetDaysInYear(Int32) GetDaysInYear(Int32)

Возвращает число дней в указанном году текущей эры.Returns the number of days in the specified year of the current era.

(Inherited from Calendar)
GetDaysInYear(Int32, Int32) GetDaysInYear(Int32, Int32) GetDaysInYear(Int32, Int32) GetDaysInYear(Int32, Int32)

Возвращает число дней в указанном году указанной эры.Returns the number of days in the specified year in the specified era.

GetEra(DateTime) GetEra(DateTime) GetEra(DateTime) GetEra(DateTime)

Возвращает значение эры из заданного объекта DateTime.Returns the era in the specified DateTime.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetHour(DateTime) GetHour(DateTime) GetHour(DateTime) GetHour(DateTime)

Возвращает значение часов в заданном DateTime.Returns the hours value in the specified DateTime.

(Inherited from Calendar)
GetLeapMonth(Int32) GetLeapMonth(Int32) GetLeapMonth(Int32) GetLeapMonth(Int32)

Вычисляет високосный месяц для заданного года.Calculates the leap month for a specified year.

(Inherited from Calendar)
GetLeapMonth(Int32, Int32) GetLeapMonth(Int32, Int32) GetLeapMonth(Int32, Int32) GetLeapMonth(Int32, Int32)

Вычисляет високосный месяц для заданных года и эры.Calculates the leap month for a specified year and era.

GetMilliseconds(DateTime) GetMilliseconds(DateTime) GetMilliseconds(DateTime) GetMilliseconds(DateTime)

Возвращает значение миллисекунд в заданном DateTime.Returns the milliseconds value in the specified DateTime.

(Inherited from Calendar)
GetMinute(DateTime) GetMinute(DateTime) GetMinute(DateTime) GetMinute(DateTime)

Возвращает значение минут в заданном DateTime.Returns the minutes value in the specified DateTime.

(Inherited from Calendar)
GetMonth(DateTime) GetMonth(DateTime) GetMonth(DateTime) GetMonth(DateTime)

Возвращает месяц в заданном типе DateTime.Returns the month in the specified DateTime.

GetMonthsInYear(Int32) GetMonthsInYear(Int32) GetMonthsInYear(Int32) GetMonthsInYear(Int32)

Возвращает число месяцев в указанном году текущей эры.Returns the number of months in the specified year in the current era.

(Inherited from Calendar)
GetMonthsInYear(Int32, Int32) GetMonthsInYear(Int32, Int32) GetMonthsInYear(Int32, Int32) GetMonthsInYear(Int32, Int32)

Возвращает число месяцев в указанном году указанной эры.Returns the number of months in the specified year in the specified era.

GetSecond(DateTime) GetSecond(DateTime) GetSecond(DateTime) GetSecond(DateTime)

Возвращает значение секунд в заданном DateTime.Returns the seconds value in the specified DateTime.

(Inherited from Calendar)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Возвращает неделю года, к которой относится дата в заданном типе DateTime.Returns the week of the year that includes the date in the specified DateTime.

GetYear(DateTime) GetYear(DateTime) GetYear(DateTime) GetYear(DateTime)

Возвращает значение года в заданном DateTime.Returns the year in the specified DateTime.

IsLeapDay(Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32)

Определяет, является ли указанная дата текущей эры високосным днем.Determines whether the specified date in the current era is a leap day.

(Inherited from Calendar)
IsLeapDay(Int32, Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32, Int32)

Определяет, является ли указанная дата указанной эры високосным днем.Determines whether the specified date in the specified era is a leap day.

IsLeapMonth(Int32, Int32) IsLeapMonth(Int32, Int32) IsLeapMonth(Int32, Int32) IsLeapMonth(Int32, Int32)

Определяет, является ли указанный месяц указанного года текущей эры високосным месяцем.Determines whether the specified month in the specified year in the current era is a leap month.

(Inherited from Calendar)
IsLeapMonth(Int32, Int32, Int32) IsLeapMonth(Int32, Int32, Int32) IsLeapMonth(Int32, Int32, Int32) IsLeapMonth(Int32, Int32, Int32)

Определяет, является ли указанный месяц указанного года указанной эры високосным месяцем.Determines whether the specified month in the specified year in the specified era is a leap month.

IsLeapYear(Int32) IsLeapYear(Int32) IsLeapYear(Int32) IsLeapYear(Int32)

Определяет, является ли указанный год текущей эры високосным годом.Determines whether the specified year in the current era is a leap year.

(Inherited from Calendar)
IsLeapYear(Int32, Int32) IsLeapYear(Int32, Int32) IsLeapYear(Int32, Int32) IsLeapYear(Int32, Int32)

Определяет, является ли указанный год указанной эры високосным годом.Determines whether the specified year in the specified era is a leap year.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Возвращает DateTime с заданными значениями даты и времени текущей эры.Returns a DateTime that is set to the specified date and time in the current era.

(Inherited from Calendar)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Возвращает DateTime с заданными значениями даты и времени в указанной эре.Returns a DateTime that is set to the specified date and time in the specified era.

ToFourDigitYear(Int32) ToFourDigitYear(Int32) ToFourDigitYear(Int32) ToFourDigitYear(Int32)

Преобразует заданный год в четырехзначное представление с использованием свойства TwoDigitYearMax для определения века.Converts the specified year to a four-digit year by using the TwoDigitYearMax property to determine the appropriate century.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Поля

CurrentEra CurrentEra CurrentEra CurrentEra

Представляет текущую эру для текущего календаря.Represents the current era of the current calendar. Значение этого поля равно 0.The value of this field is 0.

(Inherited from Calendar)

Применяется к

Дополнительно