DateTime.Today Propriedade

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Origem:

DateTime.cs

Obtém a data atual.

C#

public static DateTime Today { get; }

Valor da propriedade

DateTime

Um objeto definido como data de hoje, com o componente de tempo definido como 00:00:00.

Exemplos

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

C#

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

Comentários

A partir do .NET Framework versão 2.0, o valor retornado é um DateTime cuja Kind propriedade retorna Local.

Como ela retorna a data atual sem a hora atual, a Today propriedade é adequada para uso em aplicativos que funcionam apenas com datas. Para obter detalhes, consulte Escolhendo entre DateTime, DateTimeOffset, TimeSpan e TimeZoneInfo. Por outro lado, a TimeOfDay propriedade retorna a hora atual sem a data atual e a Now propriedade retorna a data atual e a hora atual.

Aplica-se a

Confira também

• Now
• TimeOfDay