Calendar.Eras Propriedade

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

Calendar.cs

Quando substituído em uma classe derivada, obtém a lista de eras no calendário atual.

public:
 abstract property cli::array <int> ^ Eras { cli::array <int> ^ get(); };

public abstract int[] Eras { get; }

member this.Eras : int[]

Public MustOverride ReadOnly Property Eras As Integer()

Valor da propriedade

Int32[]

Uma matriz de inteiros que representa as eras no calendário atual.

Exemplos

O exemplo a seguir exibe os valores contidos em JapaneseCalendar.Eras quando a era Heisei (1989-2019) era a era atual.

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

As eras estão em ordem cronológica inversa, com a era atual como o primeiro elemento da matriz e a era mais antiga como o último elemento da matriz. Por exemplo, o valor da era atual em JapaneseCalendar é 4, que é o primeiro elemento da matriz. Somente as JapaneseCalendar classes e dão suporte a JapaneseLunisolarCalendar várias eras.

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.

As JapaneseCalendar classes e JapaneseLunisolarCalendar dão suporte a várias eras. A maioria das implementações de calendário, por outro lado, dá suporte a uma única era.

Confira também

• CurrentEra