DateTimeOffset.MaxValue Поле

Определение

Представляет максимально допустимое значение типа DateTimeOffset. Это поле доступно только для чтения.

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

Значение поля

Исключения

DateTime.MaxValue находится за пределами диапазона текущего или указанного календаря по умолчанию для языка и региональных параметров.

Комментарии

Значение этой константы — 31.12.9999 23:59:59 +00:00.

Свойство MaxValue используется для определения того, совпадает ли значение нового DateTimeOffset объекта или DateTimeOffset значение, возвращаемое арифметической операцией, как или раньше этого максимального значения диапазона. Если это не так, метод создает исключение ArgumentOutOfRangeException. Любое DateTimeOffset значение преобразуется в формат UTC, прежде чем метод сравнивает его с MaxValue. Это означает, что DateTimeOffset значение, дата и время которого близки к максимальному диапазону, но смещение которого отрицательно, может вызвать исключение. Например, значение 31.12.9999 23:00 –02:00 выходит за пределы диапазона, так как оно на один час позже, чем MaxValue при преобразовании в формат UTC.

Некоторые календари, например UmAlQuraCalendar, поддерживают верхний диапазон дат, предшествующий MaxValue. В таких случаях попытка получить доступ MaxValue в операциях присваивания переменных или операций форматирования и синтаксического анализа может вызвать исключение ArgumentOutOfRangeException. Вместо получения значения можно получить значение последней допустимой DateTime.MaxValueдаты указанного языка и региональных параметров из Calendar.MaxSupportedDateTime свойства .

Применяется к