DateTimeFormatInfo.GetEraName(Int32) 方法

定義

命名空間:

System.Globalization

組件:

System.Runtime.dll

來源:

DateTimeFormatInfo.cs

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

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 屬性所指定曆法的有效紀元。

備註

紀元名稱是行事曆用來參照從固定點或事件算起的時間週期的名稱。 例如，“A.D.” 或 “C.E.” 是公曆中的目前紀元。

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

重要

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

給呼叫者的注意事項

如果行事歷是以 TaiwanCalendar 表示，但 CurrentCulture 不是 「zh-TW」，則 NativeCalendarName、 GetEraName(Int32)和 會 GetAbbreviatedEraName(Int32) 傳回空字串 (“”) 。

另請參閱

• GetEra(String)