Поделиться через


DateTime Структура

Определение

Представляет текущее время, обычно выраженное как дата и время суток.

Javascript Этот тип отображается как объект Date .

.ЧИСТАЯ При программировании с помощью .NET этот тип скрыт, и разработчикам следует использовать структуру System.DateTimeOffset .

C++/CX Похоже на FILETIME , но с важными отличиями. См. заметки.

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. Отрицательное значение представляет количество интервалов до 1 января 1601 года и может представлять даты примерно 27400 до н.э. Для григорианского календаря можно использовать DateTimeFormatter для создания строковых представлений DateTime для дат после полуночи в 1 году C.E.

Чтобы преобразовать UniversalTime в SYSTEMTIME, используйте ULARGE_INTEGER , чтобы преобразовать значение int64 в FILETIME, а затем используйте FileTimeToSystemTime , чтобы получить SYSTEMTIME.

В C++/WinRT DateTime похож на C++/CX тем, что имеет ту же степень детализации, что и FILETIME. В отличие от C++/CX, это специализация std::chrono::time_point а не отдельная структура. C++/WinRT предоставляет вспомогательные функции для преобразования даты и времени в FILETIME , а также в time_t. Дополнительные сведения об этих функциях см. в разделе структура winrt::clock.

Поля

UniversalTime

64-разрядное целое число со знаком, представляющее точку во времени как число 100-наносекундных интервалов до или после полуночи 1 января 1601 года (в соответствии с григорианским календарем).

Примечание

В C++/WinRT это поле не существует, так как в проекции языка DateTime является специализацией std::chrono::time_point. Если требуется необработанное целочисленное значение, используйте time_point::time_since_epoch , чтобы получить std::chrono::d uration, и используйте его метод count для получения необработанного счетчика.

Применяется к

См. также раздел