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

속성 값

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 속성을 사용 하 여 시간 구성 요소가 0 (0:00:00 또는 자정)으로 설정 된 DateTime 값의 날짜 구성 요소를 추출 합니다.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 속성에서 반환 된 날짜를 날짜 및 시간으로 misinterpreting 하지 않는 것이 중요 합니다.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.

적용 대상