DateTimeOffset.MaxValue Feld

Definition

Stellt den größtmöglichen Wert von DateTimeOffset dar. 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 Konstanten ist 31.12.9999 23:59:59 +00:00 Uhr.

Die MaxValue -Eigenschaft wird verwendet, um zu bestimmen, ob der Wert eines neuen DateTimeOffset Objekts oder der DateTimeOffset von einer arithmetischen Operation zurückgegebene Wert mit oder vor diesem Maximalen Bereichswert identisch ist. Wenn dies nicht der Fehler ist, löst die -Methode eine aus ArgumentOutOfRangeException. Jeder DateTimeOffset Wert wird in koordinierte Weltzeit (UTC) konvertiert, bevor die Methode ihn mit MaxValuevergleicht. Dies bedeutet, dass ein DateTimeOffset Wert, dessen Datum und Uhrzeit dem maximalen Bereich nahe liegen, dessen Offset jedoch negativ ist, eine Ausnahme auslösen kann. Beispielsweise liegt der Wert 31.12.9999 23:00 –02:00 Uhr außerhalb des Bereichs, da er eine Stunde später als MaxValue bei der Konvertierung in UTC liegt.

Einige Kalender, z. B. , UmAlQuraCalendarunterstützen einen oberen Datumsbereich, der vor liegt MaxValue. In diesen Fällen kann der Versuch, auf Variablenzuweisungen oder Formatierungs- und Analysevorgänge zuzugreifen MaxValue , eine ArgumentOutOfRangeExceptionauslösen. Anstatt den Wert von DateTime.MaxValueabzurufen, können Sie den Wert des letzten gültigen Datumswerts der angegebenen Kultur aus der Calendar.MaxSupportedDateTime -Eigenschaft abrufen.

Gilt für: