DateTimeFormatInfo.GetEraName(Int32) Metoda

Definicja

Przestrzeń nazw:

System.Globalization

Zestaw:

System.Runtime.dll

Źródło:

DateTimeFormatInfo.cs

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

String

Ciąg zawierający nazwę epoki.

Wyjątki

ArgumentOutOfRangeException

era nie reprezentuje prawidłowej ery w kalendarzu Calendar określonym we właściwości.

Uwagi

Nazwa ery to nazwa, której kalendarz używa do odwoływania się do okresu, który jest liowany od stałego punktu lub zdarzenia. Na przykład "A.D." lub "C.E." jest bieżącą erą w kalendarzu gregoriańskim.

Prawidłowe wartości są era wymienione we Eras właściwości odpowiedniej klasy pochodzącej z Calendarklasy . Na przykład: JapaneseCalendar.Eras wyświetla listę era, które są obsługiwane przez tę implementację.

Ważne

Era w japońskich kalendarzach opiera się na panowaniu cesarza i dlatego oczekuje się, że się zmieni. Na przykład 1 maja 2019 r. oznaczyła początek ery Reiwa w JapaneseCalendar erze i JapaneseLunisolarCalendar. Taka zmiana ery wpływa na wszystkie aplikacje korzystające z tych kalendarzy. Aby uzyskać więcej informacji i określić, czy twoje aplikacje mają wpływ, zobacz Obsługa nowej ery w kalendarzu japońskim na platformie .NET. Aby uzyskać informacje na temat testowania aplikacji w systemach Windows w celu zapewnienia gotowości do zmiany epoki, zobacz Przygotowywanie aplikacji do japońskiej zmiany epoki. Aby uzyskać informacje o funkcjach na platformie .NET, które obsługują kalendarze z wieloma erami i najlepsze rozwiązania dotyczące pracy z kalendarzami obsługującymi wiele epok, zobacz Praca z erami.

Uwagi dotyczące wywoływania

Jeśli kalendarz jest reprezentowany przez element TaiwanCalendar , ale CurrentCulture nie jest "zh-TW", to NativeCalendarName, GetEraName(Int32)i GetAbbreviatedEraName(Int32) zwraca pusty ciąg ("").

Zobacz też

• GetEra(String)