DateTimeOffset.MaxValue Pole
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 : DateTimeOffsetPublic 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 .
