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列在派生自Calendar的相应类的属性中Eras。 例如: JapaneseCalendar.Eras 显示此实现支持的时代列表。

重要

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

调用方说明

如果日历由TaiwanCalendarCurrentCulture“zh-TW”表示,则NativeCalendarNameGetEraName(Int32)返回GetAbbreviatedEraName(Int32)空字符串 (“) 。

适用于

另请参阅