Gerenciamento de tempo
Use essas funções para obter a hora atual e converter, ajustar e armazená-lo conforme necessário. A hora atual é a hora do sistema.
As rotinas _ftime e localtime usam a variável de ambiente TZ. Se TZ não for definido, a biblioteca de runtime tentará usar as informações de fuso horário especificadas pelo sistema operacional. Se essa informação não estiver disponível, essas funções usam o valor padrão de PST8PDT. Para mais informações sobre TZ, confira _tzset; veja também _daylight, timezone e _tzname.
Rotinas de tempo
| Função | Usar |
|---|---|
asctime, _wasctime, asctime_s, _wasctime_s |
Converter a hora do tipo struct tm em sequência de caracteres. As versões dessas funções com o sufixo _s são mais seguras. |
clock |
Retorne a hora do relógio decorrida no processo. |
ctime, _ctime32, _ctime64, _wctime, _wctime32_ctime_s_wctime64_ctime64_s_wctime32_s_ctime32_s_wctime_s,_wctime64_s |
Converta a hora do tipo time_t, __time32_t ou __time64_t em sequência de caracteres. As versões dessas funções com o sufixo _s são mais seguras. |
difftime, _difftime32, _difftime64 |
Calcula a diferença entre duas horas. |
_ftime, _ftime32, _ftime64,_ftime_s, _ftime32_s, _ftime64_s |
Armazenar a hora atual do sistema em variável do tipo struct _timeb ou tipo struct __timeb64 as versões dessas funções com o _s sufixo são mais seguros. |
_futime, _futime32, _futime64 |
Definir hora da modificação em arquivo aberto |
gmtime, _gmtime32, _gmtime64, gmtime_s, _gmtime32_s, , _gmtime64_s |
Converter a hora do tipo time_t em struct tm ou do tipo __time64_t em struct tm. As versões dessas funções com o sufixo _s são mais seguras. |
localtime, _localtime32, _localtime64, localtime_s, _localtime32_s, , _localtime64_s |
Converter a hora do tipo time_t em struct tm ou do tipo __time64_t em struct tm com correção local. As versões dessas funções com o sufixo _s são mais seguras. |
_mkgmtime, _mkgmtime32, _mkgmtime64 |
Converta a hora em valor de calendário o horário em valor de calendário na Hora de Greenwich. |
mktime, _mktime32, _mktime64 |
Converter a hora em valor de calendário. |
_strdate, _wstrdate, _strdate_s, _wstrdate_s |
Retorna a data atual do sistema como cadeia de caracteres. As versões dessas funções com o sufixo _s são mais seguras. |
strftime, wcsftime, _strftime_l, _wcsftime_l |
Formato de cadeia de caracteres de data e hora para uso internacional. |
_strtime, _wstrtime, _strtime_s, _wstrtime_s |
Retorna a hora atual do sistema como cadeia de caracteres. As versões dessas funções com o sufixo _s são mais seguras. |
time, _time32, _time64 |
Obtenha a hora atual do sistema como tipo time_t, __time32_t ou __time64_t. |
_tzset |
Definir variáveis de tempo externa da variável de ambiente de hora TZ. |
_utime, _utime32, _utime64, _wutime, _wutime32, , _wutime64 |
Definir o tempo de modificação de arquivo especificado usando a hora atual ou valor de hora armazenados na estrutura. |
Observação
Em todas as versões do Microsoft C/C++, exceto na versão 7.0 do Microsoft C/C++, e em todas as versões do Visual C++, a função time retorna a hora atual como o número de segundos passados desde a meia-noite de 1º de janeiro de 1970. Na versão 7.0 do Microsoft C/C++, time retornava a hora atual como o número de segundos passados desde a meia-noite de 31 de dezembro de 1899.
Observação
Em versões do Visual C++ e do Microsoft C/C++ anteriores ao Visual Studio 2005, time_t era um long int (32 bits) e, portanto, não podia ser usado para datas anteriores a 3:14:07 de 19 de janeiro de 2038, UTC. time_tAgora é equivalente a __time64_t por padrão, mas definir _USE_32BIT_TIME_T alterações time_t para __time32_t e força muitas funções de tempo para chamar as versões que usam 32 bits time_t. Para obter mais informações, consulte Tipos padrão e comentários na documentação para as funções de tempo individuais.