DateTimeFormatInfo.GetEraName(Int32) 方法

定義

命名空間:

System.Globalization

組件:

System.Globalization.dll

組件:

System.Runtime.dll

組件:

netstandard.dll

組件:

mscorlib.dll

傳回含有指定紀元名稱的字串。

public:
 System::String ^ GetEraName(int era);

public string GetEraName (int era);

member this.GetEraName : int -> string

Public Function GetEraName (era As Integer) As String

參數

era

Int32

代表紀元的整數。

傳回

String

含有紀元名稱的字串。

例外狀況

ArgumentOutOfRangeException

era 不表示 Calendar 屬性所指定曆法的有效紀元。

備註

紀元名稱是行事曆用來參考從固定點或事件全盛時期來勢洶洶的一段時間的名稱。 例如，「西元」 或「西元」 是西曆中的目前紀元。

的有效值 era 會列在 Eras 衍生自之適當類別的屬性中 Calendar 。 例如： JapaneseCalendar.Eras 顯示此執行所支援的紀元清單。

重要

日本曆法的紀元是以天皇的統治為基礎，因此有變更是正常的。 例如，2019 年 5 月 1 日之後，JapaneseCalendar 與 JapaneseLunisolarCalendar 中將開始使用「令和」。 此變更對使用這些日曆的所有應用程式都有影響。 如需詳細資訊，以及判斷您的應用程式是否受到影響，請參閱在 .net 的日文日曆中處理新的紀元。 如需在 Windows 系統上測試您的應用程式以確保其在年代的就緒狀態變更的相關資訊，請參閱準備您的應用程式以進行日本時代變更。 針對支援多個紀元日曆的 .NET 功能，以及在使用支援多個紀元的行事歷時的最佳作法，請參閱 使用紀元。

給呼叫者的注意事項

如果行事曆是以表示， TaiwanCalendar 但 CurrentCulture 不是 "ZH-華文"，則會傳回 NativeCalendarName GetEraName(Int32) GetAbbreviatedEraName(Int32) 空字串 ( "" ) 。

另請參閱

• GetEra(String)