DateTime.MinValue Campo
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa o menor valor possível de DateTime. Este campo é somente leitura.
public: static initonly DateTime MinValue;public static readonly DateTime MinValue; staticval mutable MinValue : DateTimePublic Shared ReadOnly MinValue As DateTime Valor do campo
Exemplos
O exemplo a seguir cria uma instância de um DateTime objeto passando ao construtor um Int64 valor que representa um número de tiques. Antes de invocar o construtor, o exemplo garante que esse valor seja maior ou igual a DateTime.MinValue.Ticks e menor 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 00:00:00.0000000 UTC, 1º de janeiro de 0001, no calendário gregoriano.
MinValue define a data e a hora atribuídas a uma variável não inicializada DateTime . O exemplo a seguir ilustra essa situação.
// Define an uninitialized date.
DateTime date1 = new DateTime();
Console.Write(date1);
if (date1.Equals(DateTime.MinValue))
Console.WriteLine(" (Equals Date.MinValue)");
// The example displays the following output:
// 1/1/0001 12:00:00 AM (Equals Date.MinValue)
// Define an uninitialized date.
let date1 = DateTime()
printf $"{date1}"
if date1.Equals DateTime.MinValue then
printfn $" (Equals Date.MinValue)"
// The example displays the following output:
// 1/1/0001 12:00:00 AM (Equals Date.MinValue)
' Define an uninitialized date.
Dim date1 As Date
Console.Write(date1)
If date1.Equals(Date.MinValue) Then _
Console.WriteLine(" (Equals Date.MinValue)")
' The example displays the following output:
' 1/1/0001 12:00:00 AM (Equals Date.MinValue)
As MinValue propriedades e MaxValue podem ser usadas para garantir que um valor esteja dentro do intervalo com suporte antes de passá-lo para um DateTime construtor. O código na seção Exemplo ilustra esse uso.
