JapaneseCalendar Класс

Определение

Представляет японский календарь.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
Наследование
JapaneseCalendar
Атрибуты

Комментарии

Японский календарь, который также известен как календарь Вареки, работает точно так же, как григорианский календарь, за исключением того, что год и эра различаются.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 и эры Реива, начиная с григорианского календарного года 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 — это японский календарный год Хэйсэй 13.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:

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

Этот класс обрабатывает даты с 8 сентября в году Меижи 1 (в григорианском календаре 8 сентября 1868 г.).This class handles dates from September 8 in the year Meiji 1 (in the Gregorian calendar, September 8, 1868). Хотя японский календарь был переключен из лунного календаря в солнечный календарь в году Меижи 6 (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. Високосный год в григорианском календаре определяется как григорианский год, который равномерно делится на четыре, за исключением того, что он делится на 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:

Значение в месяцGetMonth value Месяц.Month АнглийскийEnglish Дни в общих годахDays in common years Дней в високосном годуDays in leap years
11 1 月 (Ичигатсу)1月 (Ichigatsu) ЯнваряJanuary 3131 3131
22 2 月 (Нигатсу)2月 (Nigatsu) ГFebruary 2828 2929
33 3 月 (Сангатсу)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. в григорианском календаре эквивалентен первому дню Ичигатсу в японском календаре года эры 13.in the Gregorian calendar is equivalent to the first day of Ichigatsu in the year Heisei 13 in the Japanese calendar.

Если является текущим календарем японской культуры, DateTime.Parse распознает аббревиатуры эры перед годом. JapaneseCalendarIf 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. Свойство возвращает календарь по умолчанию для языка и региональных параметров, OptionalCalendars а свойство возвращает массив, содержащий все календари, поддерживаемые культурой. CalendarThe 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.Initializes a new instance of the JapaneseCalendar class.

Поля

CurrentEra

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

(Унаследовано от Calendar)

Свойства

AlgorithmType

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

DaysInYearBeforeMinSupportedYear

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

(Унаследовано от Calendar)
Eras

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

IsReadOnly

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

(Унаследовано от Calendar)
MaxSupportedDateTime

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

MinSupportedDateTime

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

TwoDigitYearMax

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

Методы

AddDays(DateTime, Int32)

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

(Унаследовано от Calendar)
AddHours(DateTime, Int32)

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

(Унаследовано от Calendar)
AddMilliseconds(DateTime, Double)

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

(Унаследовано от Calendar)
AddMinutes(DateTime, Int32)

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

(Унаследовано от Calendar)
AddMonths(DateTime, Int32)

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

AddSeconds(DateTime, Int32)

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

(Унаследовано от Calendar)
AddWeeks(DateTime, Int32)

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

(Унаследовано от Calendar)
AddYears(DateTime, Int32)

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

Clone()

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

(Унаследовано от Calendar)
Equals(Object)

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

(Унаследовано от Object)
GetDayOfMonth(DateTime)

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

GetDayOfWeek(DateTime)

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

GetDayOfYear(DateTime)

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

GetDaysInMonth(Int32, Int32)

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

(Унаследовано от Calendar)
GetDaysInMonth(Int32, Int32, Int32)

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

GetDaysInYear(Int32)

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

(Унаследовано от Calendar)
GetDaysInYear(Int32, Int32)

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

GetEra(DateTime)

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

GetHashCode()

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

(Унаследовано от Object)
GetHour(DateTime)

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

(Унаследовано от Calendar)
GetLeapMonth(Int32)

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

(Унаследовано от Calendar)
GetLeapMonth(Int32, Int32)

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

GetMilliseconds(DateTime)

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

(Унаследовано от Calendar)
GetMinute(DateTime)

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

(Унаследовано от Calendar)
GetMonth(DateTime)

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

GetMonthsInYear(Int32)

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

(Унаследовано от Calendar)
GetMonthsInYear(Int32, Int32)

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

GetSecond(DateTime)

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

(Унаследовано от Calendar)
GetType()

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

(Унаследовано от Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

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

GetYear(DateTime)

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

IsLeapDay(Int32, Int32, Int32)

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

(Унаследовано от Calendar)
IsLeapDay(Int32, Int32, Int32, Int32)

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

IsLeapMonth(Int32, Int32)

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

(Унаследовано от Calendar)
IsLeapMonth(Int32, Int32, Int32)

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

IsLeapYear(Int32)

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

(Унаследовано от Calendar)
IsLeapYear(Int32, Int32)

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

MemberwiseClone()

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

(Унаследовано от Object)
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.

(Унаследовано от Calendar)
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)

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

ToString()

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

(Унаследовано от Object)

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

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