DateTimeOffset.Date Özellik

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

DateTimeOffset.cs

Geçerli DateTimeOffset nesnenin tarih bileşenini temsil eden bir DateTime değer alır.

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

public DateTime Date { get; }

member this.Date : DateTime

Public ReadOnly Property Date As DateTime

Özellik Değeri

DateTime

DateTime Geçerli DateTimeOffset nesnenin tarih bileşenini temsil eden bir değer.

Örnekler

Aşağıdaki örnek, belirli bir tarih için özelliğinin Date değerini alır. Daha sonra bazı standart ve özel yalnızca tarih biçim tanımlayıcılarını kullanarak bu değeri konsolda görüntüler.

// 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))

Açıklamalar

Bu özellik, bir nesneden zaman bileşeninin önemli bir DateTimeOffset bölümünü kaldırır ve yalnızca önemli tarih bileşenini döndürür. Örneğin, nesnenin DateTimeOffset tarih ve saat değeri "12/12/07 4:01pm +7:30" ise, özellik "1/12/07 12:00:00 AM" değerini döndürür DateTime . Daha DateTime sonra değer, yalnızca tarihleri görüntüleyen standart veya özel biçim tanımlayıcılarından herhangi biri kullanılarak görüntülenebilir. (Çizim için Örnek bölümüne bakın.)

Döndürülen DateTime nesnenin DateTime.Kind özelliğinin değeri her zaman DateTimeKind.Unspecifiedşeklindedir. Özelliğin değerinden Offset etkilenmez.

Bir tarihi saat bileşeni olmadan görüntülemek için "D" veya "d" biçim tanımlayıcılarını da kullanabilirsiniz; bir çizim için Örnek bölümüne bakın.

Ayrıca bkz.

• Standart DateTime Biçim Dizeleri
• Özel DateTime Biçim Dizeleri