다음을 통해 공유


DateTime 구조체

정의

일반적으로 날짜와 시간으로 표현된 시간의 한 순간을 나타냅니다.

자바 스크립트 이 형식은 Date 개체로 나타납니다.

.Net .NET을 사용하여 프로그래밍할 때 이 형식은 숨겨지고 개발자는 System.DateTimeOffset 구조를 사용해야 합니다.

C++/CXFILETIME 과 비슷하지만 중요한 차이점이 있습니다. 설명 부분을 참조하세요.

C++/WinRT 이 형식은 std::chrono::time_point 특수화입니다. 설명 부분을 참조하세요.

public value class DateTime
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
struct time_point
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
public struct DateTimeOffset
var dateTime = {
universalTime : /* Your value */
}
Public Structure DateTimeOffset
상속
DateTime
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.FoundationContract (v1.0에서 도입되었습니다.)

설명

JavaScript 및 Microsoft .NET 언어는 이 형식을 직접 사용하지 않습니다. JavaScript에서 DateTime은 Date 개체로 프로젝션되고 Microsoft .NET에서는 System.DateTimeOffset으로 프로젝션됩니다. 각 언어는 각 언어에 대한 세분성 및 날짜 범위로의 변환을 투명하게 처리합니다.

Visual C++ 구성 요소 확장(C++/CX)에서 DateTime.UniversalTime 값은 FILETIME 과 세분성이 동일합니다(100나노초 간격). 양수 값의 경우 DateTime.UniversalTime 값은 FILETIME 값과 동일하지만 약 29000 C.E까지의 날짜만 나타낼 수 있습니다. 음수 값은 1601년 1월 1일 이전의 간격 수를 나타내며, BC 주 약 27,400년으로 거슬러 올라가는 날짜를 나타낼 수 있습니다. 그레고리력의 경우 DateTimeFormatter 를 사용하여 1년 1시 자정 이후 날짜에 대한 DateTime의 문자열 표현을 만들 수 있습니다.

UniversalTimeSYSTEMTIME으로 변환하려면 ULARGE_INTEGER 사용하여 int64 값을 FILETIME으로 변환한 다음 FileTimeToSystemTime을 사용하여 SYSTEMTIME을 가져옵니다.

C++/WinRT에서 DateTimeFILETIME과 세분성이 동일하다는 측면에서 C++/CX와 비슷합니다. C++/CX와 달리 고유 구조체가 아닌 std::chrono::time_point 특수화입니다. C++/WinRT는 DateTime을 FILETIMEFILETIMEtime_t 변환하는 도우미 함수를 제공합니다. 이러한 함수에 대한 자세한 내용은 winrt::clock 구조체를 참조하세요.

필드

UniversalTime

1601년 1월 1일 자정 이전 또는 이후(그레고리오력에 따라) 100나노초 간격의 수로 특정 시점을 나타내는 64비트 부호 있는 정수입니다.

참고

C++/WinRT에서는 해당 언어 프로젝션 DateTimestd::chrono::time_point 특수화이므로 이 필드가 존재하지 않습니다. 원시 정수 값이 필요한 경우 time_point::time_since_epoch 사용하여 std::chrono::d uration을 가져오고 해당 count 메서드를 사용하여 원시 개수를 가져옵니다.

적용 대상

추가 정보