DateTimeFormatInfo.GetEraName(Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca ciąg zawierający nazwę określonej ery.
public:
System::String ^ GetEraName(int era);
public string GetEraName (int era);
member this.GetEraName : int -> string
Public Function GetEraName (era As Integer) As String
Parametry
- era
- Int32
Liczba całkowita reprezentująca erę.
Zwraca
Ciąg zawierający nazwę ery.
Wyjątki
era
nie reprezentuje prawidłowej ery w kalendarzu określonym we właściwości Calendar .
Uwagi
Nazwa ery jest nazwą używaną przez kalendarz, aby odwoływać się do okresu liczonego od stałego punktu lub zdarzenia. Na przykład "A.D." lub "C.E." jest bieżącą erą w kalendarzu gregoriańskiego.
Prawidłowe wartości dla era
są wymienione we właściwości odpowiedniej klasy Eras pochodzącej od klasy Calendar . Na przykład: JapaneseCalendar.Eras wyświetla listę er, które są obsługiwane przez tę implementację.
Ważne
Ery w kalendarzach japońskich są oparte na suchem rzeszy i w związku z tym oczekuje się, że zmienią się. Na przykład 1 maja 2019 r. oznaczał początek ery Reiwa w i JapaneseCalendar JapaneseLunisolarCalendar . Taka zmiana ery ma wpływ na wszystkie aplikacje, które używają tych kalendarzy. Aby uzyskać więcej informacji i określić, czy dotyczy to aplikacji, zobacz Obsługa nowej ery w kalendarzu japońskim na platformie .NET. Aby uzyskać informacje na temat testowania aplikacji w Windows w celu zapewnienia ich gotowości na zmianę ery, zobacz Przygotowanie aplikacji na zmianę ery japońskiej. Aby uzyskać informacje o funkcjach na platformie .NET, które obsługują kalendarze z wieloma erami, oraz o najlepszych rozwiązaniach podczas pracy z kalendarzami, które obsługują wiele er, zobacz Praca z erami.
Uwagi dotyczące wywoływania
Jeśli kalendarz jest reprezentowany przez , ale element nie jest TaiwanCalendar CurrentCulture "zh-TW", a następnie , i zwraca NativeCalendarName GetEraName(Int32) pusty ciąg GetAbbreviatedEraName(Int32) ("").