JapaneseCalendar.Eras Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém a lista de eras no 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()
Valor da propriedade
Uma matriz de inteiros que representa as eras no JapaneseCalendar.
Exemplos
O exemplo a seguir exibe os valores contidos na Eras propriedade.
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
'
Comentários
O calendário japonês reconhece uma era para o reinado de cada imperador. As duas eras mais recentes são a era Heisei, começando no ano civil gregoriano de 1989, e a era Reiwa, começando no ano civil gregoriano de 2019. O nome da era normalmente é exibido antes do ano. Por exemplo, o ano civil gregoriano de 2001 é o ano civil japonês Heisei 13. Observe que o primeiro ano de uma era é chamado de "Gannen". Portanto, o ano civil gregoriano de 1989 foi o ano civil japonês Heisei Gannen.
Importante
Eras nos calendários japoneses são baseadas no reinado do imperador e, portanto, espera-se que mudem. Por exemplo, 1º de maio de 2019 marcou o início da era Reiwa no JapaneseCalendar e JapaneseLunisolarCalendar. Essa mudança de era afeta todos os aplicativos que usam esses calendários. Para obter mais informações e determinar se seus aplicativos são afetados, consulte Como lidar com uma nova era no calendário japonês no .NET. Para obter informações sobre como testar seus aplicativos em sistemas Windows para garantir sua preparação para a alteração da era, consulte Preparar seu aplicativo para a alteração da era japonesa. Para obter recursos no .NET que dão suporte a calendários com várias eras e práticas recomendadas ao trabalhar com calendários que dão suporte a várias eras, consulte Trabalhando com eras.
Essa classe atribui números às eras da seguinte maneira:
| Valor GetEra | Nome da Era | Abreviação de Era | Datas gregorianas |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | 1º de maio de 2019 para apresentar |
| 4 | 平成 (Heisei) | 平 (H, h) | 8 de janeiro de 1989 para apresentar |
| 3 | 昭和 (Showa) | 昭 (S, s) | 25 de dezembro de 1926 a 7 de janeiro de 1989 |
| 2 | 大正 (Taisho) | 大 (T, t) | 30 de julho de 1912 a 24 de dezembro de 1926 |
| 1 | 明治 (Meiji) | 明 (M, m) | 23 de outubro de 1868 a 29 de julho de 1912 |
Esta classe manipula datas de 23 de outubro no ano Meiji 1 (1º de janeiro de 1868 do calendário gregoriano). Embora o calendário japonês tenha sido alterado de um calendário lunar para um calendário solar no ano Meiji 6 (1873 do calendário gregoriano), essa implementação é baseada apenas no calendário solar.
Note
Se outras eras forem adicionadas no futuro, os aplicativos poderão encontrar mais do que as cinco eras esperadas para o calendário japonês. Teste seus aplicativos para garantir que eles continuem funcionando nesse evento. Para obter mais informações, consulte Tratamento de Era para o Calendário Japonês.