DateTimeOffset.MaxValue Feld

Definition

Stellt den größtmöglichen Wert von DateTimeOffset dar.Represents the greatest possible value of DateTimeOffset. Dieses Feld ist schreibgeschützt.This field is read-only.

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

Feldwert

Ausnahmen

MaxValue liegt außerhalb des Bereichs des Standardkalenders der aktuellen oder einer angegebenen Kultur.MaxValue is outside the range of the current or specified culture's default calendar.

Hinweise

Der Wert dieser Konstante ist 12/31/9999 11:59:59 Uhr + 00:00.The value of this constant is 12/31/9999 11:59:59 PM +00:00.

Die MaxValue-Eigenschaft wird verwendet, um zu bestimmen, ob der Wert eines neuen DateTimeOffset Objekts oder der DateTimeOffset Wert, der von einer arithmetischen Operation zurückgegeben wird, mit oder früher als dieser maximale Bereichs Wert ist.The MaxValue property is used to determine whether the value of a new DateTimeOffset object or the DateTimeOffset value returned by an arithmetic operation is the same as or earlier than this maximum range value. Wenn dies nicht der Fall ist, löst die Methode eine ArgumentOutOfRangeExceptionaus.If it is not, the method throws an ArgumentOutOfRangeException. Jeder DateTimeOffset Wert wird in die koordinierte Weltzeit (UTC) konvertiert, bevor die Methode ihn mit MaxValuevergleicht.Any DateTimeOffset value is converted to Coordinated Universal Time (UTC) before the method compares it with MaxValue. Dies bedeutet, dass ein DateTimeOffset Wert, dessen Datum und Uhrzeit in der Nähe des maximalen Bereichs liegen, dessen Abweichung jedoch negativ ist, möglicherweise eine Ausnahme auslöst.This means that a DateTimeOffset value whose date and time are close to the maximum range, but whose offset is negative, may throw an exception. Der Wert 12/31/9999 11:00 PM-02:00 liegt z. b. außerhalb des gültigen Bereichs, da er eine Stunde später als MaxValue ist, wenn er in UTC konvertiert wird.For example, the value 12/31/9999 11:00 PM -02:00 is out of range because it is one hour later than MaxValue when it is converted to UTC.

Einige Kalender, wie z. b. die UmAlQuraCalendar, unterstützen einen oberen Datumsbereich vor MaxValue.Some calendars, such as the UmAlQuraCalendar, support an upper date range that is earlier than MaxValue. In diesen Fällen kann der Versuch, auf MaxValue in Variablen Zuweisungen oder Formatierungs-und Verarbeitungsvorgängen zuzugreifen, eine ArgumentOutOfRangeExceptionauslösen.In these cases, trying to access MaxValue in variable assignments or formatting and parsing operations can throw an ArgumentOutOfRangeException. Anstatt den Wert DateTime.MaxValueabzurufen, können Sie den Wert des letzten gültigen Datums Werts der angegebenen Kultur aus der Calendar.MaxSupportedDateTime-Eigenschaft abrufen.Instead of retrieving the value of DateTime.MaxValue, you can retrieve the value of the specified culture's latest valid date value from the Calendar.MaxSupportedDateTime property.

Gilt für: