Compartilhar via


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.

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

Rotinas de tempo

Função

Uso

.Equivalente do NET Framework

asctime, _wasctime, asctime_s, _wasctime_s

Converter o tempo de tipo struct tm a seqüência de caracteres.As versões dessas funções com o _s sufixo são mais seguros.

System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString

relógio

Retorne o tempo decorrido do relógio de parede para processo.

Não aplicável.Para chamar a função c padrão, use PInvoke.Para obter mais informações, consulte Exemplos de invocação de plataforma.

a ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64, _ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s

Converter o tempo de tipo time_t, __time32_t ou __time64_t a seqüência de caracteres.As versões dessas funções com o _s sufixo são mais seguros.

System::DateTime::GetDateTimeFormats, System::DateTime::ToString, System::DateTime::ToLongTimeString, System::DateTime::ToShortTimeString

difftime, _difftime32, _difftime64

Calcule a diferença entre duas horas.

System::DateTime:: subtrair

_ftime, _ftime32, _ftime64,_ftime_s, _ftime32_s, _ftime64_s

Armazenar a hora atual do sistema na variável do tipo struct _timeb ou tipo de struct__timeb64 as versões dessas funções com o _s sufixo são mais seguros.

System::DateTime::Now

_futime, _futime32, _futime64

Defina a hora de modificação no arquivo aberto

System::IO::File::SetLastAccessTime, System::IO::File::SetLastWriteTime, System::IO::File::SetCreationTime

gmtime, _gmtime32, _gmtime64, gmtime_s, _gmtime32_s, _gmtime64_s

Converter o tempo de tipo time_t para struct tm ou do tipo __time64_t para struct tm.As versões dessas funções com o _s sufixo são mais seguros.

System::DateTime::UtcNow, System::DateTime::ToUniversalTime

localTime, _localtime32, _localtime64, localtime_s, _localtime32_s, _localtime64_s

Converter o tempo de tipo time_t para struct tm ou do tipo __time64_t para struct tmcom a correção de local.As versões dessas funções com o _s sufixo são mais seguros.

System::DateTime::ToLocalTime

_mkgmtime, _mkgmtime32, _mkgmtime64

Converta o tempo para o valor de calendário na hora de Greenwich.

System::DateTime::ToUniversalTime

mktime, _mktime32, _mktime64

Converta o tempo para o valor de calendário.

System::DateTime::DateTime

_strdate, _wstrdate, _strdate_s, _wstrdate_s

Retorna a data atual do sistema como cadeia de caracteres.As versões dessas funções com o _s sufixo são mais seguros.

Não aplicável.Para chamar a função c padrão, use PInvoke.Para obter mais informações, consulte Exemplos de invocação de plataforma.

STRFTIME, wcsftime, _strftime_l, _wcsftime_l

Formatar a seqüência de caracteres de data e hora para uso internacional.

System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString

_strtime, _wstrtime, _strtime_s, _wstrtime_s

Retorne a hora atual do sistema como cadeia de caracteres.As versões dessas funções com o _s sufixo são mais seguros.

System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString

tempo, _time32, _time64

Obter a hora atual do sistema como tipo de time_t, __time32_t ou como o tipo de __time64_t.

Não aplicável.Para chamar a função c padrão, use PInvoke.Para obter mais informações, consulte Exemplos de invocação de plataforma.

_tzset

Definir variáveis de tempo externa da variável de ambiente do tempo TZ.

Não aplicável.Para chamar a função c padrão, use PInvoke.Para obter mais informações, consulte Exemplos de invocação de plataforma.

_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64

Definir o tempo de modificação de arquivo especificado usando o horário atual ou armazenados na estrutura do valor de tempo.

Não aplicável.Para chamar a função c padrão, use PInvoke.Para obter mais informações, consulte Exemplos de invocação de plataforma.

ObservaçãoObservação

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

ObservaçãoObservação

Nas versões do Visual C++ e Microsoft C/C++, Visual C++ 2005, antes de time_t foi uma long int (32 bits) e, portanto, não podem ser usadas para datas anteriores 3: 14: 07 em 19 de janeiro de 2038, UTC.time_t Agora é equivalente a __time64_t por padrão, mas a definição de _USE_32BIT_TIME_T alterações time_t para __time32_t e muitas funções de tempo para chamar as versões que levam a 32 bits de força time_t.Para obter mais informações, consulte Tipos padrão de e comentários na documentação para as funções de hora individuais.

Consulte também

Referência

Rotinas de tempo de execução por categoria