DateTimeFormatInfo.GetEraName(Int32) 方法

定义

命名空间:

System.Globalization

程序集:

System.Runtime.dll

Source:

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)