Compartir a través de


Estructura SYSTEMTIME (minwinbase.h)

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

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)

Consulte también

FILETIME

FileTimeToSystemTime

GetLocalTime

GetSystemTime

SetLocalTime

SetSystemTime

SystemTimeToFileTime

ULARGE_INTEGER