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" 인 경우 속성은 "1/12/07 12:00:00 AM"의 DateTime 값을 반환 합니다.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.

적용 대상

추가 정보