DateTime Estructura

  • Referencia

Definición

Espacio de nombres:
Windows.Foundation
Editar

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 DateTimeOffset
var dateTime = {
universalTime : /* Your value */
}
Public Structure DateTimeOffset
Herencia
ValueType
DateTime
Atributos
ContractVersionAttribute

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.

Se aplica a

Consulte también