DateTime.Date Propriété

Définition

Obtient le composant « date » de cette instance.Gets the date component of this 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é

Nouvel objet dont la date est identique à celle de cette instance, et valeur d'heure définie à 12:00:00 minuit (00:00:00).A new object with the same date as this instance, and the time value set to 12:00:00 midnight (00:00:00).

Exemples

L’exemple suivant utilise la propriété Date pour extraire le composant de date d’une valeur DateTime avec son composant heure défini sur zéro (ou 0:00:00, ou minuit).The following example uses the Date property to extract the date component of a DateTime value with its time component set to zero (or 0:00:00, or midnight). Il illustre également que, selon la chaîne de format utilisée lors de l’affichage de la valeur DateTime, le composant heure peut continuer à apparaître dans la sortie mise en forme.It also illustrates that, depending on the format string used when displaying the DateTime value, the time component can continue to appear in formatted output.

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 propriété Kind de la valeur DateTime retournée est identique à celle de l’instance actuelle.The value of the Kind property of the returned DateTime value is the same as that of the current instance.

Étant donné que le type DateTime représente à la fois des dates et des heures dans un même type, il est important de ne pas interpréter une date retournée par la propriété Date comme une date et une heure.Because the DateTime type represents both dates and times in a single type, it is important to avoid misinterpreting a date returned by the Date property as a date and time.

S’applique à