DateTimeOffset.Date プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在の DateTime オブジェクトの日付要素を表す DateTimeOffset 値を取得します。
public:
property DateTime Date { DateTime get(); };public DateTime Date { get; }member this.Date : DateTimePublic 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" の場合、このプロパティは "1/12/07 12:00:00 AM" の値を返 DateTime します。 その DateTime 後、日付のみを表示する標準書式指定子またはカスタム書式指定子のいずれかを使用して、値を表示できます。 (図については、「例」セクションを参照してください)。
返されるDateTimeオブジェクトのDateTime.Kindプロパティの値は常にDateTimeKind.Unspecifiedです。 プロパティの値の影響を Offset 受けません。
時刻コンポーネントなしで日付を表示するには、"D" または "d" 書式指定子を使用することもできます。図については、「例」セクションを参照してください。