Поделиться через


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 находится за пределами диапазона текущего или заданного календаря по умолчанию языка и региональных параметров.

Комментарии

Значение этой константы равно 12.31.9999 11:59:59:59 :00:00.

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

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

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