DateTime.Today Eigenschaft

Definition

Ruft das aktuelle Datum ab.Gets the current date.

public:
 static property DateTime Today { DateTime get(); };
public static DateTime Today { get; }
member this.Today : DateTime
Public Shared ReadOnly Property Today As DateTime

Eigenschaftswert

Ein Objekt, das auf das heutige Datum mit einer auf 00:00:00 festgelegten Zeitkomponente festgelegt ist.An object that is set to today's date, with the time component set to 00:00:00.

Beispiele

Im folgenden Beispiel wird die Date-Eigenschaft verwendet, um das aktuelle Datum abzurufen.The following example uses the Date property to retrieve the current date. Außerdem wird veranschaulicht, wie ein DateTime-Wert mit einigen der Standardformat Zeichenfolgen für Datum und Uhrzeit formatiert werden kann.It also illustrates how a DateTime value can be formatted using some of the standard date and time format strings. Beachten Sie, dass die Ausgabe, die vom dritten Aufruf der ToString(String)-Methode erzeugt wird, den g-Format Bezeichner verwendet, um die Zeitkomponente einzubeziehen, die 0 (null) ist.Note that the output produced by the third call to the ToString(String) method uses the g format specifier to include the time component, which is zero.

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
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

Beginnend mit der .NET Framework Version 2,0 ist der Rückgabewert ein DateTime, dessen Kind-Eigenschaft Local zurückgibt.Starting with the .NET Framework version 2.0, the return value is a DateTime whose Kind property returns Local.

Da das aktuelle Datum ohne die aktuelle Zeit zurückgegeben wird, eignet sich die Today-Eigenschaft für die Verwendung in Anwendungen, die nur mit Datumsangaben arbeiten.Because it returns the current date without the current time, the Today property is suitable for use in applications that work with dates only. Weitere Informationen finden Sie unter auswählen zwischen DateTime, DateTimeOffset, TimeSpan und TimeZoneInfo.For details, see Choosing Between DateTime, DateTimeOffset, TimeSpan, and TimeZoneInfo. Im Gegensatz dazu gibt die TimeOfDay-Eigenschaft die aktuelle Uhrzeit ohne das aktuelle Datum zurück, und die Now-Eigenschaft gibt das aktuelle Datum und die aktuelle Uhrzeit zurück.In contrast, the TimeOfDay property returns the current time without the current date, and the Now property returns both the current date and the current time.

Gilt für:

Siehe auch