DateTimeOffset.Date プロパティ

定義

現在の DateTime オブジェクトの日付要素を表す DateTimeOffset 値を取得します。Gets a DateTime value that represents the date component of the current DateTimeOffset object.

public:
 property DateTime Date { DateTime get(); };
public DateTime Date { get; }
member this.Date : DateTime
Public ReadOnly Property Date As DateTime

プロパティ値

現在の DateTime オブジェクトの日付要素を表す DateTimeOffset 値。A DateTime value that represents the date component of the current DateTimeOffset object.

次の例では、特定の日付の Date プロパティの値を取得します。The following example retrieves the value of the Date property for a specific date. 次に、標準およびカスタムの日付専用書式指定子を使用して、その値をコンソールに表示します。It then displays that value to the console using some standard and custom date-only format specifiers.

// 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
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 オブジェクトから時間部分の重要な部分を削除し、その重要な日付部分のみを返します。This property removes any significant part of the time component from a DateTimeOffset object and returns only its significant date component. たとえば、DateTimeOffset オブジェクトの日付と時刻の値が "1/12/07 4: 01pm + 7:30" の場合、プロパティは DateTime 値 "1/12/07 12:00:00 AM" を返します。For example, if the DateTimeOffset object has a date and time value of "1/12/07 4:01pm +7:30", the property returns a DateTime value of "1/12/07 12:00:00 AM". DateTime 値は、日付のみを表示する標準またはカスタムの書式指定子を使用して表示できます。The DateTime value can then be displayed by using any of the standard or custom format specifiers that display dates only. (例については、「例」を参照してください)。(See the Example section for an illustration.)

返された DateTime オブジェクトの DateTime.Kind プロパティの値は常に DateTimeKind.Unspecifiedます。The value of the DateTime.Kind property of the returned DateTime object is always DateTimeKind.Unspecified. Offset プロパティの値の影響を受けません。It is not affected by the value of the Offset property.

時刻部分を含まない日付を表示するには、"D" または "d" 書式指定子を使用することもできます。図については、「例」のセクションを参照してください。To display a date without its time component, you can also use the "D" or "d" format specifiers; for an illustration, see the Example section.

適用対象

こちらもご覧ください