Bagikan melalui


DateTimeOffset.MaxValue Bidang

Definisi

Mewakili nilai terbesar yang mungkin dari DateTimeOffset. Bidang ini hanya-baca.

public: static initonly DateTimeOffset MaxValue;
public static readonly DateTimeOffset MaxValue;
 staticval mutable MaxValue : DateTimeOffset
Public 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 .

Berlaku untuk