JapaneseCalendar.Eras Propiedad

Definición

Obtiene la lista de eras de JapaneseCalendar.Gets the list of eras in the 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 de propiedad

Int32[]

Matriz de enteros que representa las eras de JapaneseCalendar.An array of integers that represents the eras in the JapaneseCalendar.

Ejemplos

En el ejemplo siguiente se muestran los valores contenidos en la Eras propiedad.The following example displays the values contained in the Eras property.

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
'

Comentarios

El calendario japonés reconoce una era para el Reino de cada emperador.The Japanese calendar recognizes one era for every emperor's reign. Las dos eras más recientes son la era Heisei, que comienza en el año 1989 del calendario gregoriano y la era REIWA, a partir del año natural 2019.The two most recent eras are the Heisei era, beginning in the Gregorian calendar year 1989, and the Reiwa era, beginning in the Gregorian calendar year 2019. El nombre de la era se muestra normalmente antes del año.The era name is typically displayed before the year. Por ejemplo, el año natural del calendario gregoriano 2001 es el año Heisei 13 del calendario japonés.For example, the Gregorian calendar year 2001 is the Japanese calendar year Heisei 13. Tenga en cuenta que el primer año de una era se denomina "gannen".Note that the first year of an era is called "Gannen." Por lo tanto, el año calendario gregoriano 1989 era el año de calendario japonés Heisei gannen.Therefore, the Gregorian calendar year 1989 was the Japanese calendar year Heisei Gannen.

Importante

Las eras en los calendarios japoneses se basan en el reino del emperador y, por tanto, se espera que cambien.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Por ejemplo, el 1 de mayo de 2019 marcaba el comienzo de la era Reiwa en JapaneseCalendar y JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Este cambio de era afecta a todas las aplicaciones que usan estos calendarios.Such a change of era affects all applications that use these calendars. Para obtener más información y determinar si sus aplicaciones están entre las afectadas, consulte Handling a new era in the Japanese calendar in .NET (Gestión de una nueva era del calendario japonés en .NET).See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Para obtener más información sobre cómo probar aplicaciones en sistemas Windows para garantizar que estén preparadas para el cambio de era, consulte Prepare your application for the Japanese era change (Preparación de la aplicación para el cambio de era japonesa).See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Consulte Trabajar con eras para ver las características de .NET que admiten calendarios con varias eras y procedimientos recomendados al trabajar con calendarios que admiten varias eras.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Esta clase asigna números a las eras de la manera siguiente:This class assigns numbers to the eras as follows:

Valor GetEraGetEra value Nombre de la eraEra Name Abreviatura de eraEra Abbreviation Fechas gregorianasGregorian Dates
55 令和 (Reiwa)令和 (Reiwa) 令和 (R, r)令和 (R, r) 1 de mayo de 2019 para presentarMay 1, 2019 to present
44 平成 (Heisei)平成 (Heisei) 平 (H, h)平 (H, h) 8 de enero de 1989 para presentarJanuary 8, 1989 to present
33 昭和 (Showa)昭和 (Showa) 昭 (S)昭 (S, s) 25 de diciembre de 1926 al 7 de enero de 1989December 25, 1926 to January 7, 1989
22 大正 (Taisho)大正 (Taisho) 大 (T, t)大 (T, t) 30 de julio de 1912 al 24 de diciembre de 1926July 30, 1912 to December 24, 1926
11 明治 (Meiji)明治 (Meiji) 明 (M, m)明 (M, m) 8 de septiembre de 1868 al 29 de julio de 1912September 8, 1868 to July 29, 1912

Esta clase controla las fechas a partir del 8 de septiembre del año Meiji 1 (1 de enero de 1868 del calendario gregoriano).This class handles dates from September 8 in the year Meiji 1 (January 1, 1868 of the Gregorian calendar). Aunque el calendario japonés se cambió de un calendario lunar a un calendario solar en el año Meiji 6 (1873 del calendario gregoriano), esta implementación solo se basa en el calendario solar.Although the Japanese calendar was switched from a lunar calendar to a solar calendar in the year Meiji 6 (1873 of the Gregorian calendar), this implementation is based on the solar calendar only.

Nota

Si se agregan eras adicionales en el futuro, es posible que las aplicaciones encuentren más de las cinco eras esperadas para el calendario japonés.Should additional eras be added in the future, applications may encounter more than the expected five eras for the Japanese calendar. Las aplicaciones deben probarse para asegurarse de que siguen funcionando en este tipo de evento. consulte control de la era para el calendario japonés.Your applications should be tested to ensure that they continue to work in such an event; see Era Handling for the Japanese Calendar.

Se aplica a

Consulte también