DateTimeOffset.Date Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает значение DateTime, представляющее компонент даты в текущем объекте DateTimeOffset.
public:
property DateTime Date { DateTime get(); };
public DateTime Date { get; }
member this.Date : DateTime
Public ReadOnly Property Date As DateTime
Значение свойства
Значение DateTime, представляющее компонент даты в текущем объекте DateTimeOffset.
Примеры
В следующем примере извлекается значение Date свойства для определенной даты. Затем оно отображает это значение в консоли, используя некоторые стандартные и настраиваемые описатели формата только для даты.
// 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))
Комментарии
Это свойство удаляет из объекта любую значительную часть компонента DateTimeOffset времени и возвращает только его значительный компонент даты. Например, если DateTimeOffset объект имеет значение даты и времени "1/12/07 4:01pm +7:30", свойство возвращает DateTime значение "1/12/07 12:00:00:00 AM". Затем DateTime значение можно отобразить с помощью любого из стандартных или настраиваемых описателей формата, которые отображают только даты. (См. раздел "Пример" для иллюстрации.)
Значение DateTime.Kind свойства возвращаемого DateTime объекта всегда DateTimeKind.Unspecifiedравно . Оно не влияет на значение Offset свойства.
Чтобы отобразить дату без компонента времени, можно также использовать описатели формата "D" или "d"; иллюстрацию см. в разделе "Пример".