DateTimeOffset.MaxValue Bidang
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili nilai terbesar yang mungkin dari DateTimeOffset. Bidang ini hanya-baca.
public: static initonly DateTimeOffset MaxValue;public static readonly DateTimeOffset MaxValue; staticval mutable MaxValue : DateTimeOffsetPublic Shared ReadOnly MaxValue As DateTimeOffset Nilai Bidang
Pengecualian
DateTime.MaxValue berada di luar rentang kalender default budaya saat ini atau yang ditentukan.
Keterangan
Nilai konstanta ini adalah 31/12/9999 11:59:59 PM +00:00.
Properti MaxValue digunakan untuk menentukan apakah nilai objek baru DateTimeOffset atau DateTimeOffset nilai yang dikembalikan oleh operasi aritmatika sama dengan atau lebih awal dari nilai rentang maksimum ini. Jika tidak, metode melempar ArgumentOutOfRangeException. Nilai apa pun DateTimeOffset dikonversi ke Waktu Universal Terkoordinasi (UTC) sebelum metode membandingkannya dengan MaxValue. Ini berarti bahwa DateTimeOffset nilai yang tanggal dan waktunya mendekati rentang maksimum, tetapi offset-nya negatif, dapat melemparkan pengecualian. Misalnya, nilai 31/12/9999 23:00 -02:00 berada di luar rentang karena satu jam lebih lambat daripada MaxValue saat dikonversi ke UTC.
Beberapa kalender, seperti UmAlQuraCalendar, mendukung rentang tanggal atas yang lebih lama dari MaxValue. Dalam kasus ini, mencoba mengakses MaxValue dalam penetapan variabel atau memformat dan mengurai operasi dapat melempar .ArgumentOutOfRangeException Alih-alih mengambil nilai DateTime.MaxValue, Anda dapat mengambil nilai nilai tanggal valid terbaru budaya yang ditentukan dari Calendar.MaxSupportedDateTime properti .
