DateTimeOffset.Date Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un DateTime valore che rappresenta il componente data dell'oggetto corrente DateTimeOffset .
public:
property DateTime Date { DateTime get(); };
public DateTime Date { get; }
member this.Date : DateTime
Public ReadOnly Property Date As DateTime
Valore della proprietà
Valore DateTime che rappresenta il componente data dell'oggetto corrente DateTimeOffset .
Esempio
Nell'esempio seguente viene recuperato il valore della Date proprietà per una data specifica. Viene quindi visualizzato tale valore nella console usando alcuni identificatori di formato standard e di sola data personalizzati.
// 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))
Commenti
Questa proprietà rimuove una parte significativa del componente temporale da un DateTimeOffset oggetto e restituisce solo il relativo componente di data significativo. Ad esempio, se l'oggetto DateTimeOffset ha un valore di data e ora "12/12/07 4:01pm +7:30", la proprietà restituisce un DateTime valore pari a "1/12/07 12:00:00 AM". Il DateTime valore può quindi essere visualizzato utilizzando uno qualsiasi degli identificatori di formato standard o personalizzati che visualizzano solo date. Per un'illustrazione, vedere la sezione Esempio.
Il valore della proprietà dell'oggetto DateTime.Kind restituito DateTime è sempre DateTimeKind.Unspecified. Non è interessato dal valore della Offset proprietà .
Per visualizzare una data senza il relativo componente ora, è anche possibile usare gli identificatori di formato "D" o "d" ; per un'illustrazione, vedere la sezione Esempio.