DateTimeOffset.MaxValue Bidang

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

DateTimeOffset.cs

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

DateTimeOffset

Pengecualian

ArgumentOutOfRangeException

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 .