Estructura SYSTEMTIME (minwinbase.h)

Artículo
02/29/2024

Especifica una fecha y hora, con miembros individuales para el mes, día, año, día de la semana, hora, minuto, segundo y milisegundos. La hora está en hora universal coordinada (UTC) o hora local, en función de la función a la que se llama.

Sintaxis

typedef struct _SYSTEMTIME {
  WORD wYear;
  WORD wMonth;
  WORD wDayOfWeek;
  WORD wDay;
  WORD wHour;
  WORD wMinute;
  WORD wSecond;
  WORD wMilliseconds;
} SYSTEMTIME, *PSYSTEMTIME, *LPSYSTEMTIME;

Miembros

wYear

Año. Los valores válidos para este miembro son de 1601 a 30827.

wMonth

El mes. Este miembro puede ser uno de los siguientes valores.

Valor	Significado
1	January
2	February
3	Marzo
4	April
5	May
6	Junio
7	Julio
8	Agosto
9	Septiembre
10	Octubre
11	Noviembre
12	Diciembre

wDayOfWeek

El día de la semana. Este miembro puede ser uno de los siguientes valores.

Valor	Significado
0	Domingo
1	Lunes
2	Martes
3	Miércoles
4	Jueves
5	Viernes
6	Sábado

wDay

El día del mes. Los valores válidos para este miembro son de 1 a 31.

wHour

La hora. Los valores válidos para este miembro son de 0 a 23.

wMinute

El minuto. Los valores válidos para este miembro son de 0 a 59.

wSecond

El segundo. Los valores válidos para este miembro son de 0 a 59.

wMilliseconds

Milisegundos. Los valores válidos para este miembro son de 0 a 999.

Comentarios

Nota

SYSTEMTIME no comprueba si la fecha representada es una fecha real y válida. Al trabajar con esta API, debe garantizar su validez, especialmente en escenarios de año bisiesto. Consulte la preparación de día bisiesto para obtener más información.

No se recomienda agregar y restar valores de la estructura SYSTEMTIME para obtener tiempos relativos. En su lugar, debe

Convierta la estructura SYSTEMTIME en una estructura FILETIME .
Copie la estructura FILETIME resultante en una estructura ULARGE_INTEGER .
Use la aritmética normal de 64 bits en el valor de ULARGE_INTEGER .

El sistema puede actualizar periódicamente la hora sincronizando con un origen de hora. Dado que la hora del sistema se puede ajustar hacia delante o hacia atrás, no compare las lecturas de tiempo del sistema para determinar el tiempo transcurrido. En su lugar, use uno de los métodos descritos en Hora de Windows.

Ejemplos

En el ejemplo siguiente se muestra la diferencia entre los valores de tiempo recuperados por las funciones GetSystemTime y GetLocalTime .

#include <windows.h>
#include <stdio.h>

void main()
{
    SYSTEMTIME st, lt;
    
    GetSystemTime(&st);
    GetLocalTime(&lt);
    
    printf("The system time is: %02d:%02d\n", st.wHour, st.wMinute);
    printf(" The local time is: %02d:%02d\n", lt.wHour, lt.wMinute);
}

// Sample output

The system time is: 19:34
 The local time is: 12:34

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Encabezado	minwinbase.h (incluya Windows.h)