DateTime.Today Propriedade

Definição

Espaço de Nomes:
System
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll
Origem:
DateTime.cs
Origem:
DateTime.cs
Origem:
DateTime.cs
Origem:
DateTime.cs
Origem:
DateTime.cs

Recebe a data atual.

public:
 static property DateTime Today { DateTime get(); };
public static DateTime Today { get; }
static member Today : DateTime
Public Shared ReadOnly Property Today As DateTime

Valor de Propriedade

DateTime

Um objeto definido para a data de hoje, com o componente temporal definido para 00:00:00.

Exemplos

O exemplo seguinte usa a Date propriedade para recuperar a data atual. Também ilustra como um DateTime valor pode ser formatado usando algumas das cadeias padrão de formato de data e hora. Note-se que a saída produzida pela terceira chamada ao ToString(String) método usa o especificador de formato g para incluir o componente de tempo, que é zero.

using System;

public class Example
{
   public static void Main()
   {
      // Get the current date.
      DateTime thisDay = DateTime.Today;
      // Display the date in the default (general) format.
      Console.WriteLine(thisDay.ToString());
      Console.WriteLine();
      // Display the date in a variety of formats.
      Console.WriteLine(thisDay.ToString("d"));
      Console.WriteLine(thisDay.ToString("D"));
      Console.WriteLine(thisDay.ToString("g"));
   }
}
// The example displays output similar to the following:
//    5/3/2012 12:00:00 AM
//
//    5/3/2012
//    Thursday, May 03, 2012
//    5/3/2012 12:00 AM

open System

// Get the current date.
let thisDay = DateTime.Today
// Display the date in the default (general) format.
printfn $"{thisDay}\n"
// Display the date in a variety of formats.
printfn $"{thisDay:d}"
printfn $"{thisDay:D}"
printfn $"{thisDay:g}"

// The example displays output similar to the following:
//    5/3/2012 12:00:00 AM
//
//    5/3/2012
//    Thursday, May 03, 2012
//    5/3/2012 12:00 AM

Module modMain
   Public Sub Main()
      ' Get the current date.
      Dim thisDay As DateTime = DateTime.Today
      ' Display the date in the default (general) format.
      Console.WriteLine(thisDay.ToString())
      Console.WriteLine()
      ' Display the date in a variety of formats.
      Console.WriteLine(thisDay.ToString("d"))
      Console.WriteLine(thisDay.ToString("D"))
      Console.WriteLine(thisDay.ToString("g"))
   End Sub
End Module
' The example displays output similar to the following:
'    5/3/2012 12:00:00 AM
'    
'    5/3/2012
'    Thursday, May 03, 2012
'    5/3/2012 12:00 AM

Observações

A partir da versão 2.0 do .NET Framework, o valor de retorno é um DateTime cuja propriedade Kind devolve Local.

Como devolve a data atual sem a hora atual, a Today propriedade é adequada para utilização em aplicações que trabalham apenas com datas. Para mais detalhes, consulte Escolher entre DateTime, DateTimeOffset, TimeSpan e TimeZoneInfo. Em contraste, a TimeOfDay propriedade devolve a hora atual sem a data atual, e a Now propriedade devolve tanto a data atual como a hora atual.

Aplica-se a

Ver também