JapaneseCalendar.Eras Propriedade

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

JapaneseCalendar.cs

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

Int32[]

Uma matriz de inteiros que representa as eras no JapaneseCalendar.

Exemplos

O exemplo a seguir exibe os valores contidos na Eras propriedade .

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
'

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

As eras nos calendários japoneses se baseiam no reinado do Imperador e, portanto, estão sujeitas a alterações. Por exemplo, 1º de maio de 2019 marcou o início da era Reiwa no JapaneseCalendar e no JapaneseLunisolarCalendar. Tal alteração de eras afeta todos os aplicativos que usam esses calendários. Para obter mais informações e determinar se seus aplicativos são afetados, consulte Manipulando 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 recursos no .NET que dão suporte a calendários com várias eras e para 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)	8 de setembro de 1868 a 29 de julho de 1912

Esta classe manipula datas de 8 de setembro no ano Meiji 1 (1º de janeiro de 1868 do calendário gregoriano). Embora o calendário japonês tenha sido alternado 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.

Observação

Se forem adicionadas eras adicionais no futuro, os aplicativos poderão encontrar mais do que as cinco eras esperadas para o calendário japonês. Seus aplicativos devem ser testados para garantir que eles continuem funcionando nesse evento; consulte Manipulação de era para o calendário japonês.

Confira também

• CurrentEra