DateTimeFormatInfo.GetEraName(Int32) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回包含指定纪元名称的字符串。
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
在派生自 的适当类的 Eras 属性中列出 Calendar 。 例如: JapaneseCalendar.Eras 显示此实现支持的纪元列表。
重要
日本历法中的年号是根据天皇统治来命名的,因此预计会发生变化。 例如,2019 年 5 月 1 日在 JapaneseCalendar 和 JapaneseLunisolarCalendar 中标志着令和年号的开始。 这种年号的变化会影响使用这些日历的所有应用程序。 有关详细信息以及如何确定应用程序是否受影响,请参阅在 .net 中的日式日历中处理新时代。 若要了解如何在 Windows 系统上测试应用程序以确保其应用程序更改的就绪性,请参阅准备应用程序以进行日本时代更改。 对于 .NET 中支持多个纪元的日历的功能,以及在处理支持多个纪元的日历时的最佳做法,请参阅使用 纪元。
调用方说明
如果日历由 表示, TaiwanCalendar 但 CurrentCulture 不是"zh-TW",则 、 和 将返回空字符串 NativeCalendarName GetEraName(Int32) GetAbbreviatedEraName(Int32) ("") 。