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	Uso
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, _wctime64, _ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_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.

Confira também

Rotinas de runtime C universais por categoria