JapaneseCalendar.Eras Propriedade
Definição
Obtém a lista de eras no 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 da propriedade
- Int32[]
Uma matriz de inteiros que representa as eras no JapaneseCalendar.An array of integers that represents the eras in the JapaneseCalendar.
Exemplos
O exemplo a seguir exibe os valores contidos na Eras propriedade.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
'
Comentários
O calendário do japonês reconhece uma era para cada Reino do Imperador.The Japanese calendar recognizes one era for every emperor's reign. Os dois mais recentes de apagamento são a era Heisei, começando no ano civil gregoriano 1989 e na era Reiwa, começando no calendário gregoriano 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. O nome da era normalmente é exibido antes do ano.The era name is typically displayed before the year. Por exemplo, o ano civil da gregoriano 2001 é o ano civil Heisei 13.For example, the Gregorian calendar year 2001 is the Japanese calendar year Heisei 13. Observe que o primeiro ano de uma era chamado de "gannen".Note that the first year of an era is called "Gannen." Portanto, o ano civil 1989 era o ano civil Heisei Gannen.Therefore, the Gregorian calendar year 1989 was the Japanese calendar year Heisei Gannen.
Importante
As eras nos calendários japoneses se baseiam no reinado do Imperador e, portanto, estão sujeitas a alterações.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Por exemplo, 1º de maio de 2019 marcou o início da era Reiwa no JapaneseCalendar e no JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Tal alteração de eras afeta todos os aplicativos que usam esses calendários.Such a change of era affects all applications that use these calendars. Veja Tratamento de uma nova era no calendário japonês no .NET para obter mais informações e para determinar se seus aplicativos são afetados.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Veja Preparar seu aplicativo para a mudança de era no calendário japonês para obter informações sobre como testar seus aplicativos em sistemas Windows para assegurar que eles estejam preparados para a alteração de era.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. Confira Trabalhando com eras para ver recursos do .NET que dão suporte a calendários com várias eras e confira práticas recomendadas de trabalho com calendários que dão suporte a várias 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.
Essa classe atribui números ao apagamento da seguinte maneira:This class assigns numbers to the eras as follows:
| Valor de GetEraGetEra value | Nome da eraEra Name | Abreviação de eraEra Abbreviation | Datas do calendário gregorianoGregorian Dates |
|---|---|---|---|
| 55 | 令和 (Reiwa)令和 (Reiwa) | 令和 (R, r)令和 (R, r) | 1º de maio de 2019 a presenteMay 1, 2019 to present |
| 44 | 平成 (Heisei)平成 (Heisei) | 平 (H, h)平 (H, h) | 8 de janeiro de 1989 para apresentarJanuary 8, 1989 to present |
| 33 | 昭和 (Showa)昭和 (Showa) | 昭 (S, s)昭 (S, s) | 25 de dezembro de 1926 a 7 de janeiro de 1989December 25, 1926 to January 7, 1989 |
| 22 | 大正 (Taisho)大正 (Taisho) | 大 (T, t)大 (T, t) | 30 de julho de 1912 a 24 de dezembro de 1926July 30, 1912 to December 24, 1926 |
| 11 | 明治 (Meiji)明治 (Meiji) | 明 (M, m)明 (M, m) | 8 de setembro de 1868 a 29 de julho de 1912September 8, 1868 to July 29, 1912 |
Essa classe manipula datas de 8 de setembro no ano Meiji 1 (1º de janeiro de 1868 do calendário gregoriano).This class handles dates from September 8 in the year Meiji 1 (January 1, 1868 of the Gregorian calendar). 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 se baseia apenas no calendário 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.
Observação
Se o apagamento adicional deve ser adicionado no futuro, os aplicativos podem encontrar mais do que os cinco apagados esperados para o calendário japonês.Should additional eras be added in the future, applications may encounter more than the expected five eras for the Japanese calendar. Seus aplicativos devem ser testados para garantir que continuem a funcionar nesse caso; consulte a manipulação de era para o calendário 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.