JapaneseCalendar.GetEra(DateTime) Método

public:
 override int GetEra(DateTime time);

public override int GetEra(DateTime time);

override this.GetEra : DateTime -> int

Public Overrides Function GetEra (time As DateTime) As Integer

Parâmetros

Devoluções

Um inteiro que representa a era no especificado DateTime.

Exceções

Exemplos

O exemplo seguinte mostra os valores de vários componentes de a DateTime em termos do calendário japonês.

using System;
using System.Globalization;

public class SamplesJapaneseCalendar  {

   public static void Main()  {

      // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      DateTime myDT = new DateTime( 2002, 4, 3, new GregorianCalendar() );

      // Creates an instance of the JapaneseCalendar.
      JapaneseCalendar myCal = new JapaneseCalendar();

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in the Japanese calendar:" );
      DisplayValues( myCal, myDT );

      // Adds two years and ten months.
      myDT = myCal.AddYears( myDT, 2 );
      myDT = myCal.AddMonths( myDT, 10 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding two years and ten months:" );
      DisplayValues( myCal, myDT );
   }

   public static void DisplayValues( Calendar myCal, DateTime myDT )  {
      Console.WriteLine( "   Era:        {0}", myCal.GetEra( myDT ) );
      Console.WriteLine( "   Year:       {0}", myCal.GetYear( myDT ) );
      Console.WriteLine( "   Month:      {0}", myCal.GetMonth( myDT ) );
      Console.WriteLine( "   DayOfYear:  {0}", myCal.GetDayOfYear( myDT ) );
      Console.WriteLine( "   DayOfMonth: {0}", myCal.GetDayOfMonth( myDT ) );
      Console.WriteLine( "   DayOfWeek:  {0}", myCal.GetDayOfWeek( myDT ) );
      Console.WriteLine();
   }
}

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar equals the following in the Japanese calendar:
   Era:        4
   Year:       14
   Month:      4
   DayOfYear:  93
   DayOfMonth: 3
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        4
   Year:       17
   Month:      2
   DayOfYear:  34
   DayOfMonth: 3
   DayOfWeek:  Thursday

*/

Imports System.Globalization


Public Class SamplesJapaneseCalendar   

   Public Shared Sub Main()

      ' Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      Dim myDT As New DateTime(2002, 4, 3, New GregorianCalendar())

      ' Creates an instance of the JapaneseCalendar.
      Dim myCal As New JapaneseCalendar()

      ' Displays the values of the DateTime.
      Console.WriteLine("April 3, 2002 of the Gregorian calendar equals the following in the Japanese calendar:")
      DisplayValues(myCal, myDT)

      ' Adds two years and ten months.
      myDT = myCal.AddYears(myDT, 2)
      myDT = myCal.AddMonths(myDT, 10)

      ' Displays the values of the DateTime.
      Console.WriteLine("After adding two years and ten months:")
      DisplayValues(myCal, myDT)

   End Sub

   Public Shared Sub DisplayValues(myCal As Calendar, myDT As DateTime)
      Console.WriteLine("   Era:        {0}", myCal.GetEra(myDT))
      Console.WriteLine("   Year:       {0}", myCal.GetYear(myDT))
      Console.WriteLine("   Month:      {0}", myCal.GetMonth(myDT))
      Console.WriteLine("   DayOfYear:  {0}", myCal.GetDayOfYear(myDT))
      Console.WriteLine("   DayOfMonth: {0}", myCal.GetDayOfMonth(myDT))
      Console.WriteLine("   DayOfWeek:  {0}", myCal.GetDayOfWeek(myDT))
      Console.WriteLine()
   End Sub

End Class


'This code produces the following output.
'
'April 3, 2002 of the Gregorian calendar equals the following in the Japanese calendar:
'   Era:        4
'   Year:       14
'   Month:      4
'   DayOfYear:  93
'   DayOfMonth: 3
'   DayOfWeek:  Wednesday
'
'After adding two years and ten months:
'   Era:        4
'   Year:       17
'   Month:      2
'   DayOfYear:  34
'   DayOfMonth: 3
'   DayOfWeek:  Thursday

Observações

O calendário japonês reconhece uma era para o reinado de cada imperador. As duas eras mais recentes são a era Heisei, que começa no ano do calendário gregoriano de 1989, e a era Reiwa, que começa no ano do calendário gregoriano de 2019. O nome da era é normalmente exibido antes do ano. Por exemplo, o ano gregoriano de 2001 é o ano japonês Heisei 13. Note-se que o primeiro ano de uma era chama-se "Gannen". Portanto, o ano do calendário gregoriano de 1989 foi o ano japonês Heisei Gannen.

Esta classe atribui números às eras da seguinte forma:

Normalmente, a classe JapaneseCalendar suporta data de 23 de outubro do ano 1 Meiji (23 de outubro de 1868 do calendário gregoriano), que é o valor da propriedade MinSupportedDateTime em versões .NET 11 e posteriores. No entanto, o GetEra método retorna com sucesso a era para datas de 1 de janeiro a 22 de outubro do ano Meiji 1 (1 de janeiro de 1868 a 22 de outubro de 1868 no calendário gregoriano). Para datas anteriores a 1 de janeiro de 1868 no calendário gregoriano, o método faz uma ArgumentOutOfRangeException exceção.

Ver também

• DateTime
• CurrentEra
• Eras
• GetYear(DateTime)
• GetMonth(DateTime)
• GetDayOfYear(DateTime)
• GetDayOfMonth(DateTime)
• GetDayOfWeek(DateTime)
• GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)
• GetHour(DateTime)
• GetMinute(DateTime)
• GetSecond(DateTime)
• GetMilliseconds(DateTime)