DateTime.Date Eigenschaft

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

DateTime.cs

Ruft die Datumskomponente dieser Instanz ab.

C#

public DateTime Date { get; }

Eigenschaftswert

DateTime

Ein neues Objekt mit demselben Datum wie diese Instanz und einer Uhrzeit von Mitternacht (00:00:00).

Beispiele

Im folgenden Beispiel wird die Date -Eigenschaft verwendet, um die Datumskomponente eines DateTime Werts zu extrahieren, dessen Zeitkomponente auf null (oder 0:00:00 oder Mitternacht) festgelegt ist. Außerdem wird veranschaulicht, dass die Zeitkomponente je nach formatierter Zeichenfolge, die beim Anzeigen des DateTime Werts verwendet wird, weiterhin in der formatierten Ausgabe angezeigt werden kann.

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

Hinweise

Der Wert der Kind -Eigenschaft des zurückgegebenen DateTime Werts entspricht dem wert 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.

Gilt für: