Compartilhar via


Estrutura SYSTEMTIME (minwinbase.h)

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

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)

Confira também

FILETIME

FileTimeToSystemTime

GetLocalTime

Getsystemtime

SetLocalTime

SetSystemTime

SystemTimeToFileTime

ULARGE_INTEGER