DateTimeFormatInfo.GetEraName(Int32) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
返回包含指定纪元名称的字符串。
public:
System::String ^ GetEraName(int era);public string GetEraName (int era);member this.GetEraName : int -> stringPublic Function GetEraName (era As Integer) As String参数
- era
- Int32
表示纪元的整数。
返回
包含纪元名称的字符串。
例外
era 不表示在 Calendar 属性中指定的日历中的有效纪元。
注解
纪元名称是日历用来引用从固定点或事件估计的时间段的名称。 例如，“A.D”。 或“C.E.” 是公历中的当前时代。
的有效值era列在派生自Calendar的相应类的属性中Eras。 例如： JapaneseCalendar.Eras 显示此实现支持的时代列表。
重要
日本历法中的年号是根据天皇统治来命名的，因此预计会发生变化。 例如，2019 年 5 月 1 日在 JapaneseCalendar 和 JapaneseLunisolarCalendar 中标志着令和年号的开始。 这种年号的变化会影响使用这些日历的所有应用程序。 有关详细信息以及如何确定应用程序是否受影响，请参阅在 .net 中的日式日历中处理新时代。 若要了解如何在 Windows 系统上测试应用程序以确保其应用程序更改的就绪性，请参阅准备应用程序以进行日本时代更改。 对于 .NET 中支持多个纪元的日历的功能，以及在处理支持多个纪元的日历时的最佳做法，请参阅使用 纪元。
调用方说明
如果日历由TaiwanCalendar非CurrentCulture“zh-TW”表示，则NativeCalendarNameGetEraName(Int32)返回GetAbbreviatedEraName(Int32)空字符串 (“) 。