DateTime.Date 屬性

定義

取得這個執行個體的日期部分。Gets the date component of this instance.

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

屬性值

新的物件,具有與這個執行個體相同的日期,並將時間值設定為午夜 12:00:00 (00:00:00)。A new object with the same date as this instance, and the time value set to 12:00:00 midnight (00:00:00).

範例

下列範例會使用 Date 屬性來解壓縮 DateTime 值的日期元件,並將其時間元件設定為零(或0:00:00 或午夜)。The following example uses the Date property to extract the date component of a DateTime value with its time component set to zero (or 0:00:00, or midnight). 它也會說明,根據顯示 DateTime 值時所使用的格式字串,時間元件可以繼續出現在格式化輸出中。It also illustrates that, depending on the format string used when displaying the DateTime value, the time component can continue to appear in formatted output.

using namespace System;

void main()
{
   DateTime^ date1 = gcnew DateTime(2008, 6, 1, 7, 47, 0);
   Console::WriteLine(date1->ToString());
   
   // Get date-only portion of date, without its time.
   DateTime dateOnly = date1->Date;
   // Display date using short date string.
   Console::WriteLine(dateOnly.ToString("d"));
   // Display date using 24-hour clock.
   Console::WriteLine(dateOnly.ToString("g"));
   Console::WriteLine(dateOnly.ToString(L"MM/dd/yyyy HH:mm"));   
}
// The example displays the following output to the console:
//       6/1/2008 7:47:00 AM
//       6/1/2008
//       6/1/2008 12:00 AM
//       06/01/2008 00:00
using System;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(2008, 6, 1, 7, 47, 0);
      Console.WriteLine(date1.ToString());
      
      // Get date-only portion of date, without its time.
      DateTime dateOnly = date1.Date;
      // Display date using short date string.
      Console.WriteLine(dateOnly.ToString("d"));
      // Display date using 24-hour clock.
      Console.WriteLine(dateOnly.ToString("g"));
      Console.WriteLine(dateOnly.ToString("MM/dd/yyyy HH:mm"));   
   }
}
// The example displays output like the following output:
//       6/1/2008 7:47:00 AM
//       6/1/2008
//       6/1/2008 12:00 AM
//       06/01/2008 00:00
Module Example
   Public Sub Main()
      Dim date1 As Date = #6/1/2008 7:47AM#
      Console.WriteLine(date1.ToString())
      
      ' Get date-only portion of date, without its time.
      Dim dateOnly As Date = date1.Date
      ' Display date using short date string.
      Console.WriteLine(dateOnly.ToString("d"))
      ' Display date using 24-hour clock.
      Console.WriteLine(dateOnly.ToString("g"))
      Console.WriteLine(dateOnly.ToString("MM/dd/yyyy HH:mm"))   
   End Sub
End Module
' The example displays output like the following:
'       6/1/2008 7:47:00 AM                     
'       6/1/2008
'       6/1/2008 12:00 AM
'       06/01/2008 00:00

備註

傳回之 DateTime 值的 Kind 屬性值,與目前實例的值相同。The value of the Kind property of the returned DateTime value is the same as that of the current instance.

因為 DateTime 類型代表單一類型中的日期和時間,所以請務必避免將 Date 屬性傳回的日期錯誤解譯為日期和時間。Because the DateTime type represents both dates and times in a single type, it is important to avoid misinterpreting a date returned by the Date property as a date and time.

適用於