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, работает точно так же, как григорианский календарь, за исключением того, что год и эра отличаются.
Примечание
Сведения об использовании 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) |