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

時代 (年号) を表す整数。

戻り値

時代 (年号) の名前を格納している文字列。

例外

era が、Calendar プロパティで指定した暦の有効な時代 (年号) を表していません。

注釈

時代 (年号) の名前は、カレンダーが固定小数点またはイベントから特定された期間を参照するために使用する名前です。 たとえば、"A.D" や "C.E" はグレゴリオ暦の現在の時代です。

の有効な値eraは、 からCalendar派生したEras適切なクラスの プロパティに一覧表示されます。 例: JapaneseCalendar.Eras この実装でサポートされている時代 (年号) の一覧が表示されます。

重要

和暦の時代 (年号) は天皇の代に基づいているため、変更されることが予想されます。 たとえば、JapaneseCalendarJapaneseLunisolarCalendar において、2019 年 5 月 1 日から令和時代が始まることになりました。 このような時代 (年号) の変更は、これらのカレンダーを使用するすべてのアプリケーションに影響します。 詳細と、アプリケーションが影響を受けるかどうかを判断するには、「 .NET での日本語カレンダーでの新しい時代 (年号の処理)」を参照してください。 Windows システムでアプリケーションをテストして時代 (年号) の変更に対する準備を確認する方法については、「 日本の時代 (年号) の変更に備える」を参照してください。 複数の時代 (年号) を含むカレンダーをサポートする .NET の機能と、複数の時代 (年号) をサポートするカレンダーを使用する場合のベスト プラクティスについては、「 年号の使用」を参照してください。

注意 (呼び出し元)

カレンダーが でTaiwanCalendar表されるが、 CurrentCulture が "zh-TW" でない場合は、、NativeCalendarNameGetEraName(Int32)GetAbbreviatedEraName(Int32) は空の文字列 ("") を返します。

適用対象

こちらもご覧ください