JapaneseLunisolarCalendar Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет время в подразделениях, таких как месяцы, дни и годы. Годы вычисляются как для японского календаря, а дни и месяцы вычисляются с помощью луносолярного календаря.
public ref class JapaneseLunisolarCalendar : System::Globalization::EastAsianLunisolarCalendarpublic class JapaneseLunisolarCalendar : System.Globalization.EastAsianLunisolarCalendar[System.Serializable]
public class JapaneseLunisolarCalendar : System.Globalization.EastAsianLunisolarCalendartype JapaneseLunisolarCalendar = class
inherit EastAsianLunisolarCalendar[<System.Serializable>]
type JapaneseLunisolarCalendar = class
inherit EastAsianLunisolarCalendarPublic Class JapaneseLunisolarCalendar
Inherits EastAsianLunisolarCalendar- Наследование
- Атрибуты
Комментарии
Класс JapaneseLunisolarCalendar является производным от EastAsianLunisolarCalendar класса, представляющего календарь lunisolar. Класс EastAsianLunisolarCalendar поддерживает цикл года сексагена (который повторяется каждые 60 лет) в дополнение к солнечным годам и лунным месяцам. Каждый солнечный год в календаре связан с сексагенарным годом, небесным стеблем и земной ветви, и эти календари могут иметь високосные месяцы после любого месяца года. Метод GetMonth возвращает число от 1 до 13, указывающее месяц, связанный с указанной датой. Если есть вискочий месяц между восьмой и девятой месяцев года, GetMonth метод возвращает 8 в восьмой месяц, 9 для вискочий восьмой месяц, и 10 на девятый месяц.
Замечание
Сведения об использовании JapaneseLunisolarCalendar класса и других классов календаря в библиотеке классов .NET см. в разделе "Работа с календарями".
Класс JapaneseLuniSolarCalendar признает одну эпоху для каждого императора правления. Например, две последние эпохи являются эрой Heisei, начиная с григорианского календарного года 1989 года, и эры Рейва, начиная с григорианского календарного года 2019 года. Имя эпохи обычно отображается до года. Например, григорианский календарный год 2001 года является японским календарным годом Heisei 13. Обратите внимание, что первый год эпохи называется "Ганнен". Поэтому григорианский календарный год 1989 года был японским календарным годом Heisei Gannen.
Это важно
Эры в японских календарях основаны на царствии императора и поэтому, как ожидается, изменятся. Например, 1 мая 2019 г. отмечено начало эпохи Reiwa в JapaneseCalendar и JapaneseLunisolarCalendar. Такое изменение эпохи влияет на все приложения, использующие эти календари. Для получения дополнительной информации и определения влияния на ваши приложения см. статью Обработка новой эпохи в японском календаре в .NET. Сведения о тестировании ваших приложений на системах Windows для обеспечения их готовности к изменению эпохи см. в разделе Подготовка приложения к изменению японской эпохи. Функции в .NET, поддерживающие календари с несколькими эрами, и рекомендации по работе с календарями, поддерживающими несколько эпох, см. в разделе Работа с эрами.
JapaneseCalendar В отличие от класса, JapaneseLunisolarCalendar класс не поддерживает даты в диапазоне эр Meiji и Тайшо.
Этот класс назначает числа эрам следующим образом:
| Значение 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 г. |
В настоящее время язык JapaneseLunisolarCalendar и региональные параметры, поддерживаемые CultureInfo классом, не используются. Поэтому этот класс можно использовать только для вычисления дат в японском луносолярном календаре. Его нельзя использовать в качестве календаря по умолчанию для любого языка и региональных параметров, поддерживаемых классом CultureInfo .
Каждый CultureInfo объект поддерживает набор календарей. Свойство CultureInfo.Calendar возвращает календарь по умолчанию для языка и региональных параметров, а CultureInfo.OptionalCalendars свойство возвращает массив, содержащий все календари, поддерживаемые языком и региональными параметрами. Календарь по умолчанию можно изменить на любой из необязательных календарей, поддерживаемых экземпляром CultureInfo . Для этого задайте Calendar для DateTimeFormatInfo свойства объекта, возвращаемого свойством CultureInfo.DateTimeFormat новое Calendar.
Конструкторы
| Имя | Описание |
|---|---|
| JapaneseLunisolarCalendar() |
Инициализирует новый экземпляр класса JapaneseLunisolarCalendar. |
Поля
| Имя | Описание |
|---|---|
| CurrentEra |
Представляет текущую эпоху текущего календаря. Значение этого поля равно 0. (Унаследовано от Calendar) |
| JapaneseEra |
Указывает текущую эпоху. |
Свойства
| Имя | Описание |
|---|---|
| AlgorithmType |
Возвращает значение, указывающее, является ли текущий календарь солнечным, лунным или сочетанием обоих. (Унаследовано от EastAsianLunisolarCalendar) |
| DaysInYearBeforeMinSupportedYear |
Возвращает количество дней в году, которое предшествует году, заданному свойством MinSupportedDateTime . |
| Eras |
Возвращает эры, относящиеся к объекту JapaneseLunisolarCalendar . |
| IsReadOnly |
Возвращает значение, указывающее, доступен ли этот Calendar объект только для чтения. (Унаследовано от Calendar) |
| MaxSupportedDateTime |
Возвращает максимальную дату и время, поддерживаемую классом JapaneseLunisolarCalendar . |
| MinSupportedDateTime |
Возвращает минимальную дату и время, поддерживаемую классом JapaneseLunisolarCalendar . |
| TwoDigitYearMax |
Возвращает или задает последний год 100-летнего диапазона, который может быть представлен 2-цифрным годом. (Унаследовано от EastAsianLunisolarCalendar) |
Методы
| Имя | Описание |
|---|---|
| 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) |
Вычисляет дату, которая является указанным числом месяцев от указанной даты. (Унаследовано от EastAsianLunisolarCalendar) |
| AddSeconds(DateTime, Int32) |
DateTime Возвращает указанное количество секунд от указанногоDateTime. (Унаследовано от Calendar) |
| AddWeeks(DateTime, Int32) |
DateTime Возвращает указанное число недель от указанногоDateTime. (Унаследовано от Calendar) |
| AddYears(DateTime, Int32) |
Вычисляет дату, которая является указанным числом лет от указанной даты. (Унаследовано от EastAsianLunisolarCalendar) |
| Clone() |
Создает новый объект, который является копией текущего Calendar объекта. (Унаследовано от Calendar) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetCelestialStem(Int32) |
Вычисляет небесный стебель указанного года в цикле сексагенария (60-летний). (Унаследовано от EastAsianLunisolarCalendar) |
| GetDayOfMonth(DateTime) |
Вычисляет день месяца в указанной дате. (Унаследовано от EastAsianLunisolarCalendar) |
| GetDayOfWeek(DateTime) |
Вычисляет день недели в указанной дате. (Унаследовано от EastAsianLunisolarCalendar) |
| GetDayOfYear(DateTime) |
Вычисляет день года в указанной дате. (Унаследовано от EastAsianLunisolarCalendar) |
| GetDaysInMonth(Int32, Int32, Int32) |
Вычисляет количество дней в указанном месяце указанного года и эпохи. (Унаследовано от EastAsianLunisolarCalendar) |
| GetDaysInMonth(Int32, Int32) |
Возвращает количество дней в указанном месяце и году текущей эпохи. (Унаследовано от Calendar) |
| GetDaysInYear(Int32, Int32) |
Вычисляет количество дней в указанном году и эре. (Унаследовано от EastAsianLunisolarCalendar) |
| GetDaysInYear(Int32) |
Возвращает количество дней в указанном году текущей эпохи. (Унаследовано от Calendar) |
| GetEra(DateTime) |
Извлекает эру, соответствующую указанному DateTime. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetHour(DateTime) |
Возвращает значение часов в указанном DateTime. (Унаследовано от Calendar) |
| GetLeapMonth(Int32, Int32) |
Вычисляет високосный месяц для указанного года и эпохи. (Унаследовано от EastAsianLunisolarCalendar) |
| GetLeapMonth(Int32) |
Вычисляет високосный месяц за указанный год. (Унаследовано от Calendar) |
| GetMilliseconds(DateTime) |
Возвращает значение миллисекунда в указанном DateTime. (Унаследовано от Calendar) |
| GetMinute(DateTime) |
Возвращает значение минут в указанном DateTime. (Унаследовано от Calendar) |
| GetMonth(DateTime) |
Возвращает месяц в указанной дате. (Унаследовано от EastAsianLunisolarCalendar) |
| GetMonthsInYear(Int32, Int32) |
Вычисляет количество месяцев в указанном году и эре. (Унаследовано от EastAsianLunisolarCalendar) |
| GetMonthsInYear(Int32) |
Возвращает количество месяцев в указанном году в текущей эре. (Унаследовано от Calendar) |
| GetSecond(DateTime) |
Возвращает значение секунд в указанном DateTime. (Унаследовано от Calendar) |
| GetSexagenaryYear(DateTime) |
Вычисляет год в цикле sexagenary (60-летний), соответствующий указанной дате. (Унаследовано от EastAsianLunisolarCalendar) |
| GetTerrestrialBranch(Int32) |
Вычисляет земную ветвь указанного года в цикле sexagenary (60-летний). (Унаследовано от EastAsianLunisolarCalendar) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Возвращает неделю года, включающую дату в указанное DateTime значение. (Унаследовано от Calendar) |
| GetYear(DateTime) |
Возвращает год в указанной дате. (Унаследовано от EastAsianLunisolarCalendar) |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Определяет, является ли указанная дата в указанной эре високосным днем. (Унаследовано от EastAsianLunisolarCalendar) |
| IsLeapDay(Int32, Int32, Int32) |
Определяет, является ли указанная дата в текущей эре високосным днем. (Унаследовано от Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Определяет, является ли указанный месяц в указанном году и эпохой високосным месяцем. (Унаследовано от EastAsianLunisolarCalendar) |
| IsLeapMonth(Int32, Int32) |
Определяет, является ли указанный месяц в указанном году в текущей эре високосным месяцем. (Унаследовано от Calendar) |
| IsLeapYear(Int32, Int32) |
Определяет, является ли указанный год в указанной эре високосным годом. (Унаследовано от EastAsianLunisolarCalendar) |
| IsLeapYear(Int32) |
Определяет, является ли указанный год в текущей эре високосным годом. (Унаследовано от Calendar) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Возвращает значение указанной DateTime даты, времени и эры. (Унаследовано от EastAsianLunisolarCalendar) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Возвращает значение указанной DateTime даты и времени в текущей эре. (Унаследовано от Calendar) |
| ToFourDigitYear(Int32) |
Преобразует указанный год в четырехзначный год. (Унаследовано от EastAsianLunisolarCalendar) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
