DateTimeOffset.Date Свойство

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

DateTimeOffset.cs

DateTime Возвращает значение, представляющее компонент даты текущего DateTimeOffset объекта.

public:
 property DateTime Date { DateTime get(); };

public DateTime Date { get; }

member this.Date : DateTime

Public ReadOnly Property Date As DateTime

Значение свойства

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"; Иллюстрация см. в разделе "Пример".

См. также раздел

• Стандартные строки формата DateTime
• Настраиваемые строки формата DateTime