DateTimeFormatInfo.GetEraName(Int32) Metode

Definisi

Ruang nama:

System.Globalization

Rakitan:

System.Runtime.dll

Sumber:

DateTimeFormatInfo.cs

Mengembalikan string yang berisi nama era yang ditentukan.

public:
 System::String ^ GetEraName(int era);

public string GetEraName (int era);

member this.GetEraName : int -> string

Public Function GetEraName (era As Integer) As String

Parameter

era

Int32

Bilangan bulat yang mewakili era.

Mengembalikan

String

String yang berisi nama era.

Pengecualian

ArgumentOutOfRangeException

era tidak mewakili era yang valid dalam kalender yang ditentukan dalam Calendar properti .

Keterangan

Nama era adalah nama yang digunakan kalender untuk merujuk pada periode waktu yang diperhitungkan dari titik atau acara tetap. Misalnya, "A.D." atau "C.E." adalah era saat ini di kalender Gregorian.

Nilai yang valid untuk era tercantum dalam Eras properti kelas yang sesuai yang berasal dari Calendar. Misalnya: JapaneseCalendar.Eras menampilkan daftar era yang didukung oleh implementasi ini.

Penting

Era di kalender Jepang didasarkan pada pemerintahan kaisar dan karenanya diharapkan berubah. Misalnya, 1 Mei 2019 menandai awal era Reiwa di JapaneseCalendar dan JapaneseLunisolarCalendar. Perubahan era seperti itu mempengaruhi semua aplikasi yang menggunakan kalender ini. Untuk informasi selengkapnya dan untuk menentukan apakah aplikasi Anda terpengaruh, lihat Menangani era baru di kalender Jepang di .NET. Untuk informasi tentang menguji aplikasi Anda pada sistem Windows untuk memastikan kesiapannya untuk perubahan era, lihat Menyiapkan aplikasi Anda untuk perubahan era Jepang. Untuk fitur di .NET yang mendukung kalender dengan beberapa era dan untuk praktik terbaik saat bekerja dengan kalender yang mendukung beberapa era, lihat Bekerja dengan era.

Catatan Bagi Pemanggil

Jika kalender diwakili oleh TaiwanCalendar tetapi CurrentCulture bukan "zh-TW", maka NativeCalendarName, GetEraName(Int32), dan GetAbbreviatedEraName(Int32) mengembalikan string kosong ("").

Lihat juga

• GetEra(String)