JapaneseCalendar.GetEra-Methode
Gibt den Zeitraum in der angegebenen DateTime zurück.
Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Overrides Function GetEra ( _
time As DateTime _
) As Integer
'Usage
Dim instance As JapaneseCalendar
Dim time As DateTime
Dim returnValue As Integer
returnValue = instance.GetEra(time)
public override int GetEra (
DateTime time
)
public:
virtual int GetEra (
DateTime time
) override
public int GetEra (
DateTime time
)
public override function GetEra (
time : DateTime
) : int
Parameter
- time
Die zu lesende DateTime.
Rückgabewert
Eine ganze Zahl, die den Zeitraum in der angegebenen DateTime darstellt.
Hinweise
Im japanischen Kalender gilt für jede Regierungszeit eines Kaisers ein neuer Zeitraum. Der aktuelle Zeitraum ist die Heisei-Zeit, die nach dem gregorianischen Kalender im Jahre 1989 begann. Der Name des Zeitraums wird i. d. R. vor der Jahreszahl angezeigt. Beispielsweise entspricht das Jahr 2001 des gregorianischen Kalenders dem Jahr Heisei 13 des japanischen Kalenders. Beachten Sie, dass das erste Jahr eines Zeitraums "Gannen" genannt wird. Das Jahr 1989 des gregorianischen Kalenders war im japanischen Kalender also das Jahr Heisei Gannen.
Diese Klasse ordnet den Zeiträumen folgendermaßen Zahlen zu:
GetEra-Wert |
Name des Zeitraums |
Abkürzung für den Zeitraum |
Gregorianische Datumsangaben |
|---|---|---|---|
4 |
平成 (Heisei) |
平 (H, h) |
8. Januar 1989 bis heute |
3 |
昭和 (Showa) |
昭 (S, s) |
25. Dezember 1926 bis 7. Januar 1989 |
2 |
大正 (Taisho) |
大 (T, t) |
30. Juli 1912 bis 24. Dezember 1926 |
1 |
明治 (Meiji) |
明 (M, m) |
8. September 1868 bis 29. Juli 1912 |
Diese Klasse verarbeitet nur Datumsangaben ab dem achten Tag des neunten Monats im Jahre Meiji 1 (8. September 1868 im gregorianischen Kalender). Obwohl der japanische Kalender im Jahre Meiji 6 vom Mondkalender auf den Sonnenkalender umgestellt wurde (1873 im gregorianischen Kalender), basiert diese Implementierung ausschließlich auf dem Sonnenkalender.
Beispiel
Im folgenden Codebeispiel werden die Werte mehrerer Komponenten von DateTime nach dem japanischen Kalender angezeigt.
Imports System
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 'Main
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 'DisplayValues
End Class 'SamplesJapaneseCalendar
'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
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
*/
using namespace System;
using namespace System::Globalization;
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();
}
int main()
{
// Sets a DateTime to April 3, 2002 of the Gregorian calendar.
DateTime myDT = DateTime(2002,4,3,gcnew GregorianCalendar);
// Creates an instance of the JapaneseCalendar.
JapaneseCalendar^ myCal = gcnew 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 );
}
/*
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
*/
import System.*;
import System.Globalization.*;
public class SamplesJapaneseCalendar
{
public static void main(String[] args)
{
// 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);
} //main
public static void DisplayValues(Calendar myCal, DateTime myDT)
{
Console.WriteLine(" Era: {0}",
System.Convert.ToString(myCal.GetEra(myDT)));
Console.WriteLine(" Year: {0}",
System.Convert.ToString(myCal.GetYear(myDT)));
Console.WriteLine(" Month: {0}",
System.Convert.ToString(myCal.GetMonth(myDT)));
Console.WriteLine(" DayOfYear: {0}",
System.Convert.ToString(myCal.GetDayOfYear(myDT)));
Console.WriteLine(" DayOfMonth: {0}",
System.Convert.ToString(myCal.GetDayOfMonth(myDT)));
Console.WriteLine(" DayOfWeek: {0}",
System.Convert.ToString(myCal.GetDayOfWeek(myDT)));
Console.WriteLine();
} //DisplayValues
} //SamplesJapaneseCalendar
/*
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
*/
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
JapaneseCalendar-Klasse
JapaneseCalendar-Member
System.Globalization-Namespace
System.DateTime
CurrentEra
Eras
GetYear
GetMonth
GetDayOfYear
GetDayOfMonth
GetDayOfWeek
Calendar.GetWeekOfYear
Calendar.GetHour
Calendar.GetMinute
Calendar.GetSecond
Calendar.GetMilliseconds