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 DateTimeOffsetvar 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 для получения необработанного счетчика. |