DateTimeOffset.Date Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
DateTime Získá hodnotu, která představuje komponentu data aktuálního DateTimeOffset objektu.
public:
property DateTime Date { DateTime get(); };
public DateTime Date { get; }
member this.Date : DateTime
Public ReadOnly Property Date As DateTime
Hodnota vlastnosti
Hodnota DateTime , která představuje komponentu data aktuálního DateTimeOffset objektu.
Příklady
Následující příklad načte hodnotu Date vlastnosti pro konkrétní datum. Pak tuto hodnotu zobrazí do konzoly pomocí některých standardních a vlastních specifikátorů formátu jen pro 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))
Poznámky
Tato vlastnost odebere z objektu libovolnou DateTimeOffset významnou část časové komponenty a vrátí pouze její významnou komponentu data. Pokud DateTimeOffset má například objekt hodnotu data a času "1/12/07 16:01 +7:30", vrátí DateTime vlastnost hodnotu "1/12/07 12:00:00 AM". Hodnotu DateTime pak lze zobrazit pomocí libovolného standardního nebo vlastního specifikátoru formátu, který zobrazuje pouze kalendářní data. (Obrázek najdete v části Příklad.)
Hodnota DateTime.Kind vlastnosti vráceného DateTime objektu je vždy DateTimeKind.Unspecified. Hodnota vlastnosti není ovlivněna Offset .
Chcete-li zobrazit datum bez jeho časové součásti, můžete také použít specifikátory formátu "D" nebo "d"; Obrázek najdete v části Příklad.