DateTime.Today Propriété

Définition

Obtient la date actuelle.

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

Valeur de propriété

Objet défini à la date d'aujourd'hui, avec le composant de l'heure défini à 00:00:00.

Exemples

L’exemple suivant utilise la Date propriété pour récupérer la date actuelle. Il illustre également comment une DateTime valeur peut être mise en forme à l’aide de certaines chaînes de format de date et d’heure standard. Notez que la sortie produite par le troisième appel à la ToString(String) méthode utilise le spécificateur de format g pour inclure le composant de temps, qui est égal à zéro.

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

Remarques

À compter de .NET Framework version 2.0, la valeur de retour est un DateTime dont Kind la propriété retourne Local.

Étant donné qu’elle retourne la date actuelle sans l’heure actuelle, la Today propriété peut être utilisée dans les applications qui fonctionnent uniquement avec des dates. Pour plus d’informations, consultez Choix entre DateTime, DateTimeOffset, TimeSpan et TimeZoneInfo. En revanche, la TimeOfDay propriété retourne l’heure actuelle sans la date actuelle, et la Now propriété retourne à la fois la date actuelle et l’heure actuelle.

S’applique à

Voir aussi