Afficher en anglais

Partage via


DateTime.Today Propriété

Définition

Obtient la date actuelle.

C#
public static DateTime Today { get; }

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.

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

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 à

Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Voir aussi