DateTime.Date Eigenschaft

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

public DateTime Date { get; }

member this.Date : DateTime

Public ReadOnly Property Date As DateTime

Eigenschaftswert

Ein neues Objekt mit demselben Datum wie diese Instanz und der Zeitwert auf 12:00:00 Mitternacht (00:00:00:00).

Beispiele

Im folgenden Beispiel wird die Date Eigenschaft verwendet, um die Datumskomponente eines DateTime Werts zu extrahieren, wobei die Zeitkomponente auf Null (oder 0:00:00 oder Mitternacht) festgelegt ist. Außerdem wird veranschaulicht, dass die Zeitkomponente abhängig von der Formatzeichenfolge, die beim Anzeigen des DateTime Werts verwendet wird, weiterhin in formatierter Ausgabe angezeigt werden kann.

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

open System

let date1 = DateTime(2008, 6, 1, 7, 47, 0)
printfn $"{date1}"

// Get date-only portion of date, without its time.
let dateOnly = date1.Date
// Display date using short date string.
printfn $"{dateOnly:d}"
// Display date using 24-hour clock.
printfn $"{dateOnly:g}"
printfn $"""{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

Hinweise

Der Wert der Kind Eigenschaft des zurückgegebenen DateTime Werts ist identisch mit der der aktuellen Instanz.

Da der DateTime Typ sowohl Datums- als auch Uhrzeitangaben in einem einzelnen Typ darstellt, ist es wichtig, ein von der Date Eigenschaft zurückgegebenes Datum als Datum und Uhrzeit falsch zu interpretieren.