DateTime.Today Propriété

Définition

Obtient la date actuelle.Gets the current date.

public:
 static property DateTime Today { DateTime get(); };
public static DateTime Today { get; }
member this.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.An object that is set to today's date, with the time component set to 00:00:00.

Exemples

L’exemple suivant utilise la propriété Date pour récupérer la date actuelle.The following example uses the Date property to retrieve the current date. Il illustre également comment une valeur DateTime peut être mise en forme à l’aide de certaines chaînes de format de date et d’heure standard.It also illustrates how a DateTime value can be formatted using some of the standard date and time format strings. Notez que la sortie produite par le troisième appel à la méthode ToString(String) utilise le spécificateur de format g pour inclure le composant d’heure, qui est égal à zéro.Note that the output produced by the third call to the ToString(String) method uses the g format specifier to include the time component, which is 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
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

À partir de la version de .NET Framework 2,0, la valeur de retour est un DateTime dont la propriété Kind retourne Local.Starting with the .NET Framework version 2.0, the return value is a DateTime whose Kind property returns Local.

Étant donné qu’elle retourne la date actuelle sans l’heure actuelle, la propriété Today peut être utilisée dans les applications qui utilisent uniquement des dates.Because it returns the current date without the current time, the Today property is suitable for use in applications that work with dates only. Pour plus d’informations, consultez choix entre DateTime, DateTimeOffset, TimeSpan et TimeZoneInfo.For details, see Choosing Between DateTime, DateTimeOffset, TimeSpan, and TimeZoneInfo. En revanche, la propriété TimeOfDay retourne l’heure actuelle sans la date actuelle, et la propriété Now retourne la date actuelle et l’heure actuelle.In contrast, the TimeOfDay property returns the current time without the current date, and the Now property returns both the current date and the current time.

S’applique à

Voir aussi