Partilhar via


Gestão do tempo

Use essas funções para obter a hora atual e convertê-la, ajustá-la e armazená-la conforme necessário. A hora atual é a hora do sistema.

As _ftime rotinas e localtime utilizam a TZ variável ambiente. Se TZ não estiver definida, a biblioteca de tempo de execução tentará usar as informações de fuso horário especificadas pelo sistema operacional. Se essas informações não estiverem disponíveis, essas funções usarão o valor padrão de PST8PDT. Para obter mais informações sobre TZ, consulte _tzset; veja também _daylight, timezonee _tzname.

Rotinas de tempo

Função Utilização
asctime, _wasctime, asctime_s, _wasctime_s Converta o tempo de tipo struct tm para cadeia de caracteres. As versões dessas funções com o sufixo _s são mais seguras.
clock Devolver o tempo de relógio de parede decorrido para o processo.
ctime, _ctime32, , _ctime64_wctime, _wctime32, _wctime64_ctime_s_ctime32_s_ctime64_s_wctime_s_wctime32_s_wctime64_s Converta o tempo do tipo time_t, __time32_t ou __time64_t da cadeia de caracteres. As versões dessas funções com o sufixo _s são mais seguras.
difftime, _difftime32, _difftime64 Calcular a diferença entre dois tempos.
_ftime, _ftime32, _ftime64, ,_ftime_s , _ftime32_s_ftime64_s Armazene a hora atual do sistema em variável de tipo struct _timeb ou tipo struct __timeb64 As versões dessas funções com o sufixo _s são mais seguras.
_futime, _futime32, _futime64 Definir o tempo de modificação no arquivo aberto
gmtime, _gmtime32, _gmtime64, gmtime_s, _gmtime32_s, _gmtime64_s Converta o tempo de tipo time_t para struct tm ou de tipo __time64_t para 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 Converta o tempo de tipo time_t para struct tm ou de tipo __time64_t para com struct tm correção local. As versões dessas funções com o sufixo _s são mais seguras.
_mkgmtime, _mkgmtime32, _mkgmtime64 Converta o tempo em valor de calendário em Greenwich Mean Time.
mktime, _mktime32, _mktime64 Converta tempo em valor de calendário.
_strdate, _wstrdate, _strdate_s, _wstrdate_s Retorne a data atual do sistema como string. As versões dessas funções com o sufixo _s são mais seguras.
strftime, wcsftime, _strftime_l, _wcsftime_l Formatar cadeia de caracteres de data e hora para uso internacional.
_strtime, _wstrtime, _strtime_s, _wstrtime_s Retorne a hora atual do sistema como string. As versões dessas funções com o sufixo _s são mais seguras.
time, _time32, _time64 Obter a hora atual do sistema como tipo time_t, __time32_t ou como tipo __time64_t.
_tzset Defina variáveis de tempo externas a partir da variável TZde tempo do ambiente.
_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64 Defina o tempo de modificação para o arquivo especificado usando o tempo atual ou o valor de tempo armazenado na estrutura.

Observação

Em todas as versões do Microsoft C/C++, exceto Microsoft C/C++ versão 7.0 e em todas as versões do Visual C++, a função de tempo retorna a hora atual como o número de segundos decorridos desde a meia-noite de 1º de janeiro de 1970. No Microsoft C/C++ versão 7.0, time retornou a hora atual como o número de segundos decorridos desde a meia-noite de 31 de dezembro de 1899.

Observação

Em versões do Visual C++ e Microsoft C/C++ antes do Visual Studio 2005, era um time_t (32 bits) e, portanto, long int não podia ser usado para datas anteriores a 3:14:07 19 de janeiro de 2038, UTC. time_t agora é equivalente a __time64_t por padrão, mas a definição _USE_32BIT_TIME_T de alterações time_t__time32_t e força muitas funções de tempo a chamar versões que usam o 32-bit time_t. Para obter mais informações, consulte Tipos padrão e comentários na documentação para as funções de tempo individuais.

Ver também

Rotinas de tempo de execução Universal C por categoria