DateTime.MaxValue Campo

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTime.cs

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

public: static initonly DateTime MaxValue;

public static readonly DateTime MaxValue;

 staticval mutable MaxValue : DateTime

Public Shared ReadOnly MaxValue As DateTime 

Valor do campo

DateTime

Exemplos

O exemplo a seguir cria uma instância de um DateTime objeto passando ao construtor um Int64 valor que representa uma série de tiques. Antes de invocar o construtor, o exemplo garante que esse valor seja maior ou igual a DateTime.MinValue.Ticks e menor que ou igual a DateTime.MaxValue.Ticks. Caso contrário, ele lançará um ArgumentOutOfRangeException.

// Attempt to assign an out-of-range value to a DateTime constructor.
long numberOfTicks = Int64.MaxValue;
DateTime validDate;

// Validate the value.
if (numberOfTicks >= DateTime.MinValue.Ticks &&
    numberOfTicks <= DateTime.MaxValue.Ticks)
   validDate = new DateTime(numberOfTicks);
else if (numberOfTicks < DateTime.MinValue.Ticks)
   Console.WriteLine("{0:N0} is less than {1:N0} ticks.",
                     numberOfTicks,
                     DateTime.MinValue.Ticks);
else
   Console.WriteLine("{0:N0} is greater than {1:N0} ticks.",
                     numberOfTicks,
                     DateTime.MaxValue.Ticks);
// The example displays the following output:
//   9,223,372,036,854,775,807 is greater than 3,155,378,975,999,999,999 ticks.

// Attempt to assign an out-of-range value to a DateTime constructor.
let numberOfTicks = Int64.MaxValue

// Validate the value.
if numberOfTicks >= DateTime.MinValue.Ticks &&
   numberOfTicks <= DateTime.MaxValue.Ticks then
    let validDate = DateTime numberOfTicks
    ()
elif numberOfTicks < DateTime.MinValue.Ticks then
    printfn $"{numberOfTicks:N0} is less than {DateTime.MinValue.Ticks:N0} ticks."
else
    printfn $"{numberOfTicks:N0} is greater than {DateTime.MaxValue.Ticks:N0} ticks."
// The example displays the following output:
//   9,223,372,036,854,775,807 is greater than 3,155,378,975,999,999,999 ticks.

' Attempt to assign an out-of-range value to a DateTime constructor.
Dim numberOfTicks As Long = Int64.MaxValue
Dim validDate As Date

' Validate the value.
If numberOfTicks >= Date.MinValue.Ticks And _
   numberOfTicks <= Date.MaxValue.Ticks Then
   validDate = New Date(numberOfTicks)
ElseIf numberOfTicks < Date.MinValue.Ticks Then
   Console.WriteLine("{0:N0} is less than {1:N0} ticks.", 
                     numberOfTicks, 
                     DateTime.MinValue.Ticks)      
Else                                                   
   Console.WriteLine("{0:N0} is greater than {1:N0} ticks.", 
                     numberOfTicks, 
                     DateTime.MaxValue.Ticks)     
End If
' The example displays the following output:
'   9,223,372,036,854,775,807 is greater than 3,155,378,975,999,999,999 ticks.

Comentários

O valor dessa constante é equivalente a 23:59:59.9999999 UTC, 31 de dezembro de 9999 no calendário gregoriano, exatamente um tique de 100 nanossegundos antes das 00:00:00 UTC, 1 de janeiro de 10000.

Alguns calendários, como o , dão suporte a ThaiBuddhistCalendarum 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 .

Confira também

• MinValue