Freigeben über


DateTimeOffset.MaxValue Feld

Definition

Stellt den größtmöglichen Wert von DateTimeOffset. Dieses Feld ist schreibgeschützt.

public: static initonly DateTimeOffset MaxValue;
public static readonly DateTimeOffset MaxValue;
 staticval mutable MaxValue : DateTimeOffset
Public Shared ReadOnly MaxValue As DateTimeOffset 

Feldwert

Ausnahmen

DateTime.MaxValue liegt außerhalb des Bereichs des Standardkalenders der aktuellen oder angegebenen Kultur.

Hinweise

Der Wert dieser Konstante ist 12.31.9999 11:59:59 Uhr +00:00 Uhr.

Die MaxValue Eigenschaft wird verwendet, um zu bestimmen, ob der Wert eines neuen DateTimeOffset Objekts oder der DateTimeOffset von einem arithmetischen Vorgang zurückgegebene Wert mit oder vor diesem Maximalen Bereichswert identisch ist. Wenn dies nicht der Fehler ist, löst die Methode eine ArgumentOutOfRangeException. Jeder DateTimeOffset Wert wird in koordinierte Weltzeit (COORDINATED Universal Time, UTC) konvertiert, bevor die Methode sie mit MaxValueder Methode vergleicht. Dies bedeutet, dass ein DateTimeOffset Wert, dessen Datum und Uhrzeit sich nahe am maximalen Bereich befinden, deren Offset jedoch negativ ist, eine Ausnahme auslösen kann. Beispielsweise ist der Wert 12/31/9999 11:00 -02:00 außerhalb des Bereichs, da er eine Stunde später als MaxValue bei der Konvertierung in UTC liegt.

Einige Kalender, z. B. die UmAlQuraCalendar, unterstützen einen oberen Datumsbereich, der früher als MaxValueist. In diesen Fällen kann der VersuchMaxValue, auf variable Zuordnungen oder Formatierungen zuzugreifen, und Analysevorgänge auslösen.ArgumentOutOfRangeException Anstatt den Wert DateTime.MaxValueabzurufen, können Sie den Wert des letzten gültigen Datumswerts der angegebenen Kultur aus der Calendar.MaxSupportedDateTime Eigenschaft abrufen.

Gilt für: