DateTime.Today Propriété

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

DateTime.cs

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é

DateTime

Objet défini sur la date du jour, avec le composant d’heure défini sur 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 une DateTime propriété qui Kind retourne Local.

Étant donné qu’elle retourne la date actuelle sans l’heure actuelle, la Today propriété est adaptée à une utilisation 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.

Voir aussi

• Now
• TimeOfDay