DateTimeFormatInfo.GetEraName(Int32) Metoda

Definicja

Zwraca ciąg zawierający nazwę określonego ery.Returns the string containing the name of the specified era.

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 ERA.The integer representing the era.

Zwraca

String

Ciąg zawierający nazwę ERA.A string containing the name of the era.

Wyjątki

era nie reprezentuje prawidłowej ery w kalendarzu określonym we właściwości Calendar.era does not represent a valid era in the calendar specified in the Calendar property.

Uwagi

Nazwa era to nazwa, która jest stosowana przez kalendarz do odwoływania się do określonego czasu z ustalonego punktu lub zdarzenia.The era name is the name a calendar uses to refer to a period of time reckoned from a fixed point or event. Na przykład "N.E."For example, "A.D." lub "0001"or "C.E." to bieżąca ERA w kalendarzu gregoriańskim.is the current era in the Gregorian calendar.

Prawidłowe wartości dla era są wymienione we właściwości Eras odpowiedniej klasie pochodzącej z Calendar.The valid values for era are listed in the Eras property of the appropriate class derived from Calendar. Na przykład: JapaneseCalendar.Eras wyświetla listę wymazów, które są obsługiwane przez tę implementację.For example: JapaneseCalendar.Eras displays a list of eras that are supported by this implementation.

Ważne

Ery kalendarza japońskiego opierają się na reign imperatora i w związku z tym są powinna się zmienić.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Na przykład 1 maja 2019 oznaczony początku ery Reiwa JapaneseCalendar i JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Zmiana era ma wpływ na wszystkie aplikacje, które używają tych kalendarzy.Such a change of era affects all applications that use these calendars. Zobacz obsługi nowej ery usług w kalendarza japońskiego na platformie .NET uzyskać więcej informacji, jak i do określenia aplikacji, których dotyczy problem.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Zobacz przygotowanie aplikacji w taki sposób, aby ta zmiana era japoński instrukcje dotyczące testowania aplikacji w systemach Windows w celu zapewnienia ich gotowości, aby ta zmiana 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. Zobacz Praca z erami dla funkcji na platformie .NET, które obsługują kalendarzach z erami wielu i najlepsze rozwiązania, gdy praca z kalendarzami, które obsługują wiele er.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.

Uwagi dotyczące wywoływania

Jeśli kalendarz jest reprezentowany przez TaiwanCalendar ale CurrentCulture nie jest "zh-TW", wówczas NativeCalendarName, GetEraName(Int32)i GetAbbreviatedEraName(Int32) zwracają pusty ciąg ("").If the calendar is represented by TaiwanCalendar but the CurrentCulture is not "zh-TW", then NativeCalendarName, GetEraName(Int32), and GetAbbreviatedEraName(Int32) return an empty string ("").

Dotyczy

Zobacz też