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

表示纪元的整数。

返回

String

包含纪元名称的字符串。

例外

era 不表示在 Calendar 属性中指定的日历中的有效纪元。

注解

纪元名称是日历用于表示从固定点或事件开始的时间周期的名称。 例如,"A.D"。 或"C.E"。 是公历中的当前纪元。

的有效值 era 在派生自 的适当类的 Eras 属性中列出 Calendar 。 例如: JapaneseCalendar.Eras 显示此实现支持的纪元列表。

重要

日本历法中的年号是根据天皇统治来命名的,因此预计会发生变化。 例如,2019 年 5 月 1 日在 JapaneseCalendarJapaneseLunisolarCalendar 中标志着令和年号的开始。 这种年号的变化会影响使用这些日历的所有应用程序。 有关详细信息以及如何确定应用程序是否受影响,请参阅在 .net 中的日式日历中处理新时代。 若要了解如何在 Windows 系统上测试应用程序以确保其应用程序更改的就绪性,请参阅准备应用程序以进行日本时代更改。 对于 .NET 中支持多个纪元的日历的功能,以及在处理支持多个纪元的日历时的最佳做法,请参阅使用 纪元

调用方说明

如果日历由 表示, TaiwanCalendarCurrentCulture 不是"zh-TW",则 、 和 将返回空字符串 NativeCalendarName GetEraName(Int32) GetAbbreviatedEraName(Int32) ("") 。

适用于

另请参阅