DateTime.Date Propriété

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Obtient le composant « date » de cette instance.

C#

public DateTime Date { get; }

Valeur de propriété

DateTime

Nouvel objet dont la date est identique à celle de cette instance, et valeur d'heure définie à 12:00:00 minuit (00:00:00).

Exemples

L’exemple suivant utilise la Date propriété pour extraire le composant de date d’une DateTime valeur avec son composant heure défini sur zéro (ou 0:00:00, ou minuit). Il illustre également que, en fonction de la chaîne de format utilisée lors de l’affichage de la DateTime valeur, le composant heure peut continuer à apparaître dans la sortie mise en forme.

C#

using System;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(2008, 6, 1, 7, 47, 0);
      Console.WriteLine(date1.ToString());

      // Get date-only portion of date, without its time.
      DateTime dateOnly = date1.Date;
      // Display date using short date string.
      Console.WriteLine(dateOnly.ToString("d"));
      // Display date using 24-hour clock.
      Console.WriteLine(dateOnly.ToString("g"));
      Console.WriteLine(dateOnly.ToString("MM/dd/yyyy HH:mm"));
   }
}
// The example displays output like the following output:
//       6/1/2008 7:47:00 AM
//       6/1/2008
//       6/1/2008 12:00 AM
//       06/01/2008 00:00

Remarques

La valeur de la Kind propriété de la valeur retournée DateTime est identique à celle de l’instance actuelle.

Étant donné que le DateTime type représente à la fois des dates et des heures dans un même type, il est important d’éviter de malinterpréter une date retournée par la Date propriété sous la forme d’une date et d’une heure.

S’applique à