DateTime Estructura
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un instante de tiempo, normalmente expresado en forma de fecha y hora del día.
Javascript Este tipo aparece como el objeto Date .
.RED Al programar con .NET, este tipo está oculto y los desarrolladores deben usar la estructura System.DateTimeOffset .
C++/CX Similar a FILETIME , pero con diferencias importantes. Vea la sección Comentarios.
C++/WinRT Este tipo es una especialización de std::chrono::time_point. Vea la sección Comentarios.
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- Herencia
-
DateTime
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.FoundationContract (se introdujo en la versión v1.0)
|
Comentarios
Los lenguajes JavaScript y Microsoft .NET no usan este tipo directamente. En JavaScript, dateTime se proyecta como un objeto Date y en Microsoft .NET se proyecta como System.DateTimeOffset. Cada idioma controla de forma transparente la conversión a los intervalos de granularidad y fecha del idioma correspondiente.
En las extensiones de componentes de Visual C++ (C++/CX), un valor DateTime.UniversalTime tiene la misma granularidad que filetime (intervalos de 100 nanosegundos). En el caso de los valores positivos, un valor DateTime.UniversalTime es idéntico a un valor FILETIME , aunque solo puede representar fechas de hasta 29000 C.E. Un valor negativo representa el número de intervalos anteriores al 1 de enero de 1601 y puede representar fechas anteriores a aproximadamente 27.400 B.C.E. Para el calendario gregoriano, puede usar dateTimeFormatter para crear representaciones de cadena de una fecha y hora para las fechas posteriores a la medianoche del año 1 C.E.
Para convertir UniversalTime en SYSTEMTIME, use ULARGE_INTEGER para convertir el valor int64 enFILETIME y, a continuación, use FileTimeToSystemTime para obtener SYSTEMTIME.
En C++/WinRT, DateTime es similar a C++/CX en que tiene la misma granularidad que filetime. A diferencia de C++/CX, es una especialización de std::chrono::time_point en lugar de una estructura distinta. C++/WinRT proporciona funciones auxiliares para convertir DateTime en y desde FILETIME y hacia y desde time_t. Para obtener más información sobre estas funciones, consulta winrt::clock struct.
Campos
| UniversalTime |
Entero de 64 bits con signo que representa un momento dado como el número de intervalos de 100 nanosegundos antes o después de medianoche el 1 de enero de 1601 (según el calendario gregoriano). Nota En C++/WinRT, este campo no existe, porque en esa proyección de lenguaje DateTime es una especialización de std::chrono::time_point. Si necesita el valor entero sin procesar, use time_point::time_since_epoch para obtener una std::chrono::d uration y use su método count para obtener el recuento sin procesar. |