DateTimeOffset.MaxValue Pole

Definicja

Reprezentuje największą możliwą wartość .DateTimeOffset To pole jest tylko do odczytu.

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

Wartość pola

Wyjątki

DateTime.MaxValue znajduje się poza zakresem domyślnego kalendarza bieżącej lub określonej kultury.

Uwagi

Wartość tej stałej to 12/31/9999 11:59:59 PM +00:00.

Właściwość MaxValue służy do określania, czy wartość nowego DateTimeOffset obiektu lub DateTimeOffset wartość zwracana przez operację arytmetyczną jest taka sama jak lub wcześniejsza niż ta maksymalna wartość zakresu. Jeśli tak nie jest, metoda zgłasza błąd ArgumentOutOfRangeException. Każda DateTimeOffset wartość jest konwertowana na uniwersalny czas koordynowany (UTC) przed porównaniem jej z MaxValuemetodą . Oznacza to, że DateTimeOffset wartość, której data i godzina są zbliżone do maksymalnego zakresu, ale którego przesunięcie jest ujemne, może zgłosić wyjątek. Na przykład wartość 12/31/9999 11:00 -02:00 jest poza zakresem, ponieważ jest godzina późniejsza niż MaxValue podczas konwersji na czas UTC.

Niektóre kalendarze, takie jak UmAlQuraCalendar, obsługują górny zakres dat, który jest wcześniejszy niż MaxValue. W takich przypadkach próba uzyskania dostępu MaxValue w przypisaniach zmiennych lub operacjach formatowania i analizowania może zgłosić błąd ArgumentOutOfRangeException. Zamiast pobierać wartość DateTime.MaxValue, można pobrać wartość najnowszej prawidłowej wartości daty określonej kultury z Calendar.MaxSupportedDateTime właściwości .

Dotyczy