Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
|
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.