DateTime.Today Eigenschaft

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

DateTime.cs

Ruft das aktuelle Datum ab.

public:
 static property DateTime Today { DateTime get(); };

public static DateTime Today { get; }

static member Today : DateTime

Public Shared ReadOnly Property Today As DateTime

Eigenschaftswert

DateTime

Ein Objekt, das auf das heutige Datum festgelegt ist, wobei die Zeitkomponente auf 00:00:00 festgelegt ist.

Beispiele

Im folgenden Beispiel wird die Date Eigenschaft verwendet, um das aktuelle Datum abzurufen. Außerdem wird veranschaulicht, wie ein DateTime Wert mithilfe einiger der Standardmäßigen Datums- und Uhrzeitformatzeichenfolgen formatiert werden kann. Beachten Sie, dass die ausgabe, die vom dritten Aufruf der ToString(String) Methode erzeugt wird, den g-Formatbezeichner verwendet, um die Zeitkomponente einzuschließen, die Null ist.

using System;

public class Example
{
   public static void Main()
   {
      // Get the current date.
      DateTime thisDay = DateTime.Today;
      // Display the date in the default (general) format.
      Console.WriteLine(thisDay.ToString());
      Console.WriteLine();
      // Display the date in a variety of formats.
      Console.WriteLine(thisDay.ToString("d"));
      Console.WriteLine(thisDay.ToString("D"));
      Console.WriteLine(thisDay.ToString("g"));
   }
}
// The example displays output similar to the following:
//    5/3/2012 12:00:00 AM
//
//    5/3/2012
//    Thursday, May 03, 2012
//    5/3/2012 12:00 AM

open System

// Get the current date.
let thisDay = DateTime.Today
// Display the date in the default (general) format.
printfn $"{thisDay}\n"
// Display the date in a variety of formats.
printfn $"{thisDay:d}"
printfn $"{thisDay:D}"
printfn $"{thisDay:g}"

// The example displays output similar to the following:
//    5/3/2012 12:00:00 AM
//
//    5/3/2012
//    Thursday, May 03, 2012
//    5/3/2012 12:00 AM

Module modMain
   Public Sub Main()
      ' Get the current date.
      Dim thisDay As DateTime = DateTime.Today
      ' Display the date in the default (general) format.
      Console.WriteLine(thisDay.ToString())
      Console.WriteLine()
      ' Display the date in a variety of formats.
      Console.WriteLine(thisDay.ToString("d"))
      Console.WriteLine(thisDay.ToString("D"))
      Console.WriteLine(thisDay.ToString("g"))
   End Sub
End Module
' The example displays output similar to the following:
'    5/3/2012 12:00:00 AM
'    
'    5/3/2012
'    Thursday, May 03, 2012
'    5/3/2012 12:00 AM

Hinweise

Ab .NET Framework, Version 2.0, ist der Rückgabewert eine DateTime , deren Kind Eigenschaft zurückgegeben wird Local.

Da es das aktuelle Datum ohne die aktuelle Uhrzeit zurückgibt, eignet sich die Today Eigenschaft nur für Anwendungen, die nur mit Datumsangaben arbeiten. Ausführliche Informationen finden Sie unter "Auswählen zwischen DateTime", "DateTimeOffset", "TimeSpan" und "TimeZoneInfo". Im Gegensatz dazu gibt die TimeOfDay Eigenschaft die aktuelle Uhrzeit ohne das aktuelle Datum zurück, und die Now Eigenschaft gibt sowohl das aktuelle Datum als auch die aktuelle Uhrzeit zurück.

Weitere Informationen

• Now
• TimeOfDay