DateTime.Date Propriété

Référence

Définition

Espace de noms:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient le composant « date » de cette instance.

public:
 property DateTime Date { DateTime get(); };

public DateTime Date { get; }

member this.Date : DateTime

Public ReadOnly Property Date As DateTime

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.

using namespace System;

void main()
{
   DateTime^ date1 = gcnew 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(L"MM/dd/yyyy HH:mm"));   
}
// The example displays the following output to the console:
//       6/1/2008 7:47:00 AM
//       6/1/2008
//       6/1/2008 12:00 AM
//       06/01/2008 00:00

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

Module Example
   Public Sub Main()
      Dim date1 As Date = #6/1/2008 7:47AM#
      Console.WriteLine(date1.ToString())
      
      ' Get date-only portion of date, without its time.
      Dim dateOnly As Date = 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"))   
   End Sub
End Module
' The example displays output like the following:
'       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 à