JapaneseCalendar.Eras Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает список эр в классе JapaneseCalendar.
public:
virtual property cli::array <int> ^ Eras { cli::array <int> ^ get(); };public override int[] Eras { get; }member this.Eras : int[]Public Overrides ReadOnly Property Eras As Integer()Значение свойства
Массив целых чисел для представления эр в классе JapaneseCalendar.
Примеры
В следующем примере отображаются значения, содержащиеся в свойстве Eras .
using namespace System;
using namespace System::Globalization;
int main()
{
// Creates and initializes a JapaneseCalendar.
JapaneseCalendar^ myCal = gcnew JapaneseCalendar;
// Displays the values in the Eras property.
for ( int i = 0; i < myCal->Eras->Length; i++ )
{
Console::WriteLine( "Eras[ {0}] = {1}", i, myCal->Eras[ i ] );
}
}
/*
This code produces the following output.
Eras->Item[0] = 4
Eras->Item[1] = 3
Eras->Item[2] = 2
Eras->Item[3] = 1
*/
using System;
using System.Globalization;
public class SamplesJapaneseCalendar {
public static void Main() {
// Creates and initializes a JapaneseCalendar.
JapaneseCalendar myCal = new JapaneseCalendar();
// Displays the values in the Eras property.
for ( int i = 0; i < myCal.Eras.Length; i++ ) {
Console.WriteLine( "Eras[{0}] = {1}", i, myCal.Eras[i] );
}
}
}
/*
This code produces the following output.
Eras[0] = 4
Eras[1] = 3
Eras[2] = 2
Eras[3] = 1
*/
Imports System.Globalization
Public Class SamplesJapaneseCalendar
Public Shared Sub Main()
' Creates and initializes a JapaneseCalendar.
Dim myCal As New JapaneseCalendar()
' Displays the values in the Eras property.
Dim i As Integer
For i = 0 To myCal.Eras.Length - 1
Console.WriteLine("Eras[{0}] = {1}", i, myCal.Eras(i))
Next i
End Sub
End Class
'This code produces the following output.
'
'Eras[0] = 4
'Eras[1] = 3
'Eras[2] = 2
'Eras[3] = 1
'
Комментарии
Японский календарь признает одну эпоху для правления каждого императора. Две последние эпохи — эра Хэйсэй, начиная с григорианского календарного года 1989 года, и эра Рейва, начиная с григорианского календарного года 2019 года. Название эры обычно отображается до года. Например, григорианский календарный год 2001 является японским календарным годом Heisei 13. Обратите внимание, что первый год эры называется "Ганнен". Таким образом, григорианский календарный год 1989 года был японским календарным годом Хэйсэй Ганнен.
Важно!
Эры в японских календарях основаны на периодах царствования императоров. Таким образом, ожидается наступление новой эры. Например, 1 мая 2019 года в JapaneseCalendar и JapaneseLunisolarCalendar отмечено как начало эры Рэйва. Изменение эры затрагивает все приложения, использующие эти календари. Дополнительные сведения и определение того, затронуты ли ваши приложения, см. в статье Обработка новой эры в японском календаре в .NET. Сведения о тестировании приложений в системах Windows для обеспечения их готовности к изменению эпохи см. в статье Подготовка приложения к изменению японской эры. Сведения о функциях в .NET, поддерживающих календари с несколькими эрами, а также рекомендации по работе с календарями, поддерживающими несколько эпох, см. в статье Работа с эрами.
Этот класс присваивает числа эрам следующим образом:
| Значение GetEra | Имя эры | Аббревиатура эры | Григорианские даты |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | С 1 мая 2019 г. по настоящее время |
| 4 | 平成 (Хэйсэй) | 平 (H, h) | 8 января 1989 г. по настоящее время |
| 3 | 昭和 (Showa) | 昭 (S, s) | 25 декабря 1926 г. по 7 января 1989 г. |
| 2 | 大正 (Тайсё) | 大 (T, t) | 30 июля 1912 г. по 24 декабря 1926 г. |
| 1 | 明治 (Мэйдзи) | 明 (M, m) | 8 сентября 1868 г. по 29 июля 1912 г. |
Этот класс обрабатывает даты с 8 сентября в году Мэйдзи 1 (1 января 1868 года по григорианскому календарю). Хотя японский календарь был переключен с лунного календаря на солнечный в году Мэйдзи 6 (1873 григорианский календарь), эта реализация основана только на солнечном календаре.
Примечание
Если в будущем будут добавлены дополнительные эры, приложения могут столкнуться с большими, чем ожидалось пятью эрами японского календаря. Приложения должны быть протестированы, чтобы убедиться, что они продолжают работать в таком случае; См . раздел Обработка эры для японского календаря.
