Estrutura SYSTEMTIME (minwinbase.h)

Artigo
08/24/2023

Especifica uma data e hora, usando membros individuais para o mês, dia, ano, dia da semana, hora, minuto, segundo e milissegundos. A hora está em UTC (tempo universal coordenado) ou hora local, dependendo da função que está sendo chamada.

Sintaxe

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

Membros

wYear

O ano. Os valores válidos para esse membro são 1601 a 30827.

wMonth

O mês. Esse membro pode ser um dos valores a seguir.

Valor	Significado
1	Janeiro
2	Fevereiro
3	Março
4	Abril
5	Mai
6	Junho
7	Julho
8	Agosto
9	Setembro
10	Outubro
11	Novembro
12	Dezembro

wDayOfWeek

O dia da semana. Esse membro pode ser um dos valores a seguir.

Valor	Significado
0	Sunday
1	Monday
2	Terça-feira
3	Quarta-feira
4	Quinta-feira
5	Friday
6	Sábado

wDay

O dia do mês. Os valores válidos para esse membro são de 1 a 31.

wHour

A hora. Os valores válidos para esse membro são de 0 a 23.

wMinute

O minuto. Os valores válidos para esse membro são de 0 a 59.

wSecond

O segundo. Os valores válidos para esse membro são de 0 a 59.

wMilliseconds

O milissegundo. Os valores válidos para esse membro são de 0 a 999.

Comentários

Observação

O SYSTEMTIME não marcar para ver se a data representada é uma data real e válida. Ao trabalhar com essa API, você deve garantir sua validade, especialmente em cenários de ano bissexto. Confira preparação para o dia bissexto para obter mais informações.

Não é recomendável adicionar e subtrair valores da estrutura SYSTEMTIME para obter tempos relativos. Em vez disso, você deve

Converta a estrutura SYSTEMTIME em uma estrutura FILETIME .
Copie a estrutura FILETIME resultante para uma estrutura ULARGE_INTEGER .
Use aritmética normal de 64 bits no valor ULARGE_INTEGER .

O sistema pode atualizar periodicamente a hora sincronizando com uma fonte de tempo. Como o tempo do sistema pode ser ajustado para frente ou para trás, não compare as leituras de tempo do sistema para determinar o tempo decorrido. Em vez disso, use um dos métodos descritos em Tempo do Windows.

Exemplos

O exemplo a seguir demonstra a diferença entre os valores de tempo recuperados pelas funções GetSystemTime e 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	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Cabeçalho	minwinbase.h (inclua Windows.h)