DateTimeOffset.Date Eigenschaft

Definition

Ruft einen DateTime-Wert ab, der die Datumskomponente des aktuellen DateTimeOffset-Objekts darstellt.Gets a DateTime value that represents the date component of the current DateTimeOffset object.

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

Eigenschaftswert

Ein DateTime-Wert, der die Datumskomponente des aktuellen DateTimeOffset-Objekts darstellt.A DateTime value that represents the date component of the current DateTimeOffset object.

Beispiele

Im folgenden Beispiel wird der Wert der Date-Eigenschaft für ein bestimmtes Datum abgerufen.The following example retrieves the value of the Date property for a specific date. Dieser Wert wird dann in der Konsole mithilfe einiger standardmäßiger und benutzerdefinierter Datums-Format Bearbeiter angezeigt.It then displays that value to the console using some standard and custom date-only format specifiers.

// Illustrate Date property and date formatting
DateTimeOffset thisDate = new DateTimeOffset(2008, 3, 17, 1, 32, 0, new TimeSpan(-5, 0, 0));
string fmt;                      // format specifier

// Display date only using "D" format specifier
// For en-us culture, displays:
//   'D' format specifier: Monday, March 17, 2008
fmt = "D";
Console.WriteLine("'{0}' format specifier: {1}",  
                  fmt, thisDate.Date.ToString(fmt));

// Display date only using "d" format specifier
// For en-us culture, displays:
//   'd' format specifier: 3/17/2008
fmt = "d";
Console.WriteLine("'{0}' format specifier: {1}",  
                  fmt, thisDate.Date.ToString(fmt));

// Display date only using "Y" (or "y") format specifier
// For en-us culture, displays:
//   'Y' format specifier: March, 2008
fmt = "Y";
Console.WriteLine("'{0}' format specifier: {1}",  
                  fmt, thisDate.Date.ToString(fmt));
                  
// Display date only using custom format specifier
// For en-us culture, displays:
//   'dd MMM yyyy' format specifier: 17 Mar 2008
fmt = "dd MMM yyyy";
Console.WriteLine("'{0}' format specifier: {1}",  
                  fmt, thisDate.Date.ToString(fmt));
' Illustrate Date property and date formatting
Dim thisDate As New DateTimeOffset(#3/17/2008 1:32AM#, New TimeSpan(-5, 0, 0))
Dim fmt As String                    ' format specifier
' Display date only using "D" format specifier
' For en-us culture, displays:
'   'D' format specifier: Monday, March 17, 2008
fmt = "D"
Console.WriteLine("'{0}' format specifier: {1}", _ 
                  fmt, thisDate.Date.ToString(fmt))

' Display date only using "d" format specifier
' For en-us culture, displays:
'   'd' format specifier: 3/17/2008
fmt = "d"
Console.WriteLine("'{0}' format specifier: {1}", _ 
                  fmt, thisDate.Date.ToString(fmt))

' Display date only using "Y" (or "y") format specifier
' For en-us culture, displays:
'   'Y' format specifier: March, 2008
fmt = "Y"
Console.WriteLine("'{0}' format specifier: {1}", _ 
                  fmt, thisDate.Date.ToString(fmt))
                  
' Display date only using custom format specifier
' For en-us culture, displays:
'   'dd MMM yyyy' format specifier: 17 Mar 2008
fmt = "dd MMM yyyy"
Console.WriteLine("'{0}' format specifier: {1}", _ 
                  fmt, thisDate.Date.ToString(fmt))

Hinweise

Diese Eigenschaft entfernt einen beliebigen signifikanten Teil der Zeitkomponente aus einem DateTimeOffset Objekt und gibt nur die bedeutende Datums Komponente zurück.This property removes any significant part of the time component from a DateTimeOffset object and returns only its significant date component. Wenn das DateTimeOffset Objekt z. b. einen Datums-und Uhrzeitwert von "1/12/07 4:01PM + 7:30" aufweist, gibt die-Eigenschaft den DateTime Wert "1/12/07 12:00:00 am" zurück.For example, if the DateTimeOffset object has a date and time value of "1/12/07 4:01pm +7:30", the property returns a DateTime value of "1/12/07 12:00:00 AM". Der DateTime Wert kann dann mithilfe eines beliebigen Standard-oder benutzerdefinierten Format bezeichnerwerts angezeigt werden, der nur Datumsangaben anzeigt.The DateTime value can then be displayed by using any of the standard or custom format specifiers that display dates only. (Eine Abbildung finden Sie im Beispiel Abschnitt.)(See the Example section for an illustration.)

Der Wert der DateTime.Kind-Eigenschaft des zurückgegebenen DateTime Objekts ist immer DateTimeKind.Unspecified.The value of the DateTime.Kind property of the returned DateTime object is always DateTimeKind.Unspecified. Der Wert der Offset-Eigenschaft ist nicht betroffen.It is not affected by the value of the Offset property.

Wenn Sie ein Datum ohne Zeitkomponente anzeigen möchten, können Sie auch die Format Bearbeiter "d" oder "d" verwenden. eine Abbildung finden Sie im Beispiel Abschnitt.To display a date without its time component, you can also use the "D" or "d" format specifiers; for an illustration, see the Example section.

Gilt für:

Siehe auch