JapaneseCalendar.Eras Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene la lista de eras de 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
Matriz de enteros que representa las eras de JapaneseCalendar.
Ejemplos
En el ejemplo siguiente se muestran los valores contenidos en la Eras propiedad .
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 reinado de cada emperador. Las dos eras más recientes son la era Heisei, a partir del año natural gregoriano 1989, y la era Reiwa, comenzando en el año natural gregoriano 2019. El nombre de la era se muestra normalmente antes del año. Por ejemplo, el año natural gregoriano 2001 es el año natural japonés Heisei 13. Tenga en cuenta que el primer año de una era se denomina "Gannen". Por lo tanto, el año natural gregoriano 1989 fue el año natural japonés Heisei Gannen.
Importante
Las eras en los calendarios japoneses se basan en el reino del emperador y, por tanto, se espera que cambien. Por ejemplo, el 1 de mayo de 2019 marcaba el comienzo de la era Reiwa en JapaneseCalendar y JapaneseLunisolarCalendar. Este cambio de era afecta a todas las aplicaciones que usan estos calendarios. Para obtener más información y determinar si las aplicaciones se ven afectadas, consulte Control de una nueva era en el calendario japonés en .NET. Para obtener información sobre cómo probar las aplicaciones en sistemas Windows para garantizar su preparación para el cambio de era, consulte Preparación de la aplicación para el cambio en la era japonesa. Para conocer las características de .NET que admiten calendarios con varias eras y procedimientos recomendados al trabajar con calendarios que admiten varias eras, consulte Trabajar con eras.
Esta clase asigna números a las eras de la siguiente manera:
| Valor getEra | Nombre de la era | Abreviatura de era | Fechas gregorianas |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | 1 de mayo de 2019 para presentar |
| 4 | 平成 (Heisei) | 平 (H, h) | 8 de enero de 1989 para presentar |
| 3 | 昭和 (Showa) | 昭 (S, s) | 25 de diciembre de 1926 al 7 de enero de 1989 |
| 2 | 正 (Taisho) | (T, t) | 30 de julio de 1912 al 24 de diciembre de 1926 |
| 1 | 明治 (Meiji) | 明 (M, m) | 8 de septiembre de 1868 al 29 de julio de 1912 |
Esta clase controla las fechas del 8 de septiembre del año Meiji 1 (1 de enero de 1868 del calendario gregoriano). 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 se basa únicamente en el calendario solar.
Nota
Si se agregan eras adicionales en el futuro, las aplicaciones pueden encontrar más de las cinco eras esperadas para el calendario japonés. Las aplicaciones deben probarse para asegurarse de que siguen funcionando en este tipo de evento; consulte Control de era para el calendario japonés.
