DateTimeOffset.Date Eigenschap

Definitie

Naamruimte:
System
Assembly's:
mscorlib.dll, System.Runtime.dll
Assembly's:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs

Hiermee haalt u een DateTime waarde op die het datumonderdeel van het huidige DateTimeOffset object vertegenwoordigt.

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

Waarde van eigenschap

DateTime

Een DateTime waarde die het datumonderdeel van het huidige DateTimeOffset object vertegenwoordigt.

Voorbeelden

In het volgende voorbeeld wordt de waarde van de Date eigenschap opgehaald voor een specifieke datum. Vervolgens wordt die waarde weergegeven aan de console met een aantal standaard- en aangepaste notatieaanduidingen voor alleen-datum.

// 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
let thisDate = DateTimeOffset(2008, 3, 17, 1, 32, 0, TimeSpan(-5, 0, 0))

// Display date only using "D" format specifier
// For en-us culture, displays:
//   'D' format specifier: Monday, March 17, 2008
let fmt = "D"
printfn $"'{fmt}' format specifier: {thisDate.Date.ToString fmt}"

// Display date only using "d" format specifier
// For en-us culture, displays:
//   'd' format specifier: 3/17/2008
let fmt = "d"
printfn $"'{fmt}' format specifier: {thisDate.Date.ToString fmt}"

// Display date only using "Y" (or "y") format specifier
// For en-us culture, displays:
//   'Y' format specifier: March, 2008
let fmt = "Y"
printfn $"'{fmt}' format specifier: {thisDate.Date.ToString fmt}"

// Display date only using custom format specifier
// For en-us culture, displays:
//   'dd MMM yyyy' format specifier: 17 Mar 2008
let fmt = "dd MMM yyyy"
printfn $"'{fmt}' format specifier: {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))

Opmerkingen

Met deze eigenschap wordt een belangrijk deel van het tijdonderdeel uit een DateTimeOffset object verwijderd en wordt alleen het significante datumonderdeel geretourneerd. Als het DateTimeOffset object bijvoorbeeld een datum- en tijdwaarde heeft van '1-12-07 12:01pm +7:30', retourneert de eigenschap een DateTime waarde van '1-12-07 12:00:00 uur'. De DateTime waarde kan vervolgens worden weergegeven met een van de standaard- of aangepaste notatieaanduidingen die alleen datums weergeven. (Zie de sectie Voorbeeld voor een afbeelding.)

De waarde van de DateTime.Kind eigenschap van het geretourneerde DateTime object is altijd DateTimeKind.Unspecified. Dit wordt niet beïnvloed door de waarde van de Offset eigenschap.

Als u een datum zonder het tijdonderdeel wilt weergeven, kunt u ook de notatieaanduidingen D of D gebruiken; Zie de sectie Voorbeeld voor een afbeelding.

Van toepassing op

Zie ook