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 は、 から派生した Eras 適切なクラスの プロパティに一覧表示されます Calendar 。 たとえば、 は JapaneseCalendar.Eras 、この実装でサポートされている時代 (年) の一覧を表示します。

重要

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

注意 (呼び出し元)

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

適用対象

こちらもご覧ください