共用方式為


DateTimeFormatInfo.GetEraName(Int32) 方法

定義

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

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

代表紀元的整數。

傳回

含有紀元名稱的字串。

例外狀況

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

備註

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

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

重要

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

給呼叫者的注意事項

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

適用於

另請參閱