DateTimeOffset.MaxValue Campo

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTimeOffset.cs

Representa o maior valor possível de DateTimeOffset. Este campo é somente leitura.

public: static initonly DateTimeOffset MaxValue;

public static readonly DateTimeOffset MaxValue;

 staticval mutable MaxValue : DateTimeOffset

Public Shared ReadOnly MaxValue As DateTimeOffset 

Valor do campo

DateTimeOffset

Exceções

ArgumentOutOfRangeException

DateTime.MaxValue está fora do intervalo do calendário padrão da cultura atual ou especificada.

Comentários

O valor dessa constante é 31/12/9999 11:59:59 PM +00:00.

A MaxValue propriedade é usada para determinar se o valor de um novo DateTimeOffset objeto ou o DateTimeOffset valor retornado por uma operação aritmética é igual ou anterior a esse valor de intervalo máximo. Se não for, o método gerará um ArgumentOutOfRangeException. Qualquer DateTimeOffset valor é convertido em UTC (Tempo Universal Coordenado) antes que o método o compare com MaxValue. Isso significa que um DateTimeOffset valor cuja data e hora estão perto do intervalo máximo, mas cujo deslocamento é negativo, pode gerar uma exceção. Por exemplo, o valor 31/12/9999 23:00 -02:00 está fora do intervalo porque é uma hora mais tarde do que MaxValue quando é convertido em UTC.

Alguns calendários, como o , dão suporte a UmAlQuraCalendarum intervalo de datas superior que é anterior a MaxValue. Nesses casos, tentar acessar MaxValue em atribuições de variáveis ou operações de formatação e análise pode gerar um ArgumentOutOfRangeException. Em vez de recuperar o valor de DateTime.MaxValue, você pode recuperar o valor do valor de data válido mais recente da cultura especificada da Calendar.MaxSupportedDateTime propriedade .