Compartilhar via


Gerenciamento de tempo

Use essas funções para obter a hora atuais e convert, ajuste-as, e armazenar-l conforme necessário. A hora atual for a hora do sistema.

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

Rotinas hora

Função

Uso

Equivalente a .NET Framework

asctime, _wasctime, asctime_s, _wasctime_s

Converter o tipo tempo struct tm à cadeia de caracteres. As versões dessas funções com o sufixo de _s são mais seguros.

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

relógio

O retorno decorrido tempo do relógio para o processo.

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

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

Converter o tipo tempo time_t, __time32_t ou __time64_t à cadeia de caracteres. As versões dessas funções com o sufixo de _s são mais seguros.

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

difftime, _difftime32, _difftime64

Diferença de cálculo entre duas vezes em.

System::DateTime::Subtract

_ftime, _ftime32, _ftime64,_ftime_s, _ftime32_s, _ftime64_s

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

System::DateTime::Now

_futime, _futime32, _futime64

Definir o tempo de alteraçã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

Tempo de conversão de tipotime_t para oustruct tm do tipo__time64_t parastruct tm.As versões dessas funções com o sufixo de _s são mais seguros.

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

localtime, _localtime32, _localtime64, localtime_s, _localtime32_s, _localtime64_s

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

System::DateTime::ToLocalTime

_mkgmtime, _mkgmtime32, _mkgmtime64

Tempo de conversão calendar o valor na hora de Greenwich.

System::DateTime::ToUniversalTime

mktime, _mktime32, _mktime64

Tempo de conversão calendar o valor.

System::DateTime::DateTime

_strdate, _wstrdate, _strdate_s, _wstrdate_s

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

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

strftime, wcsftime, _strftime_l, _wcsftime_l

Cadeia de caracteres de data/hora de formato para uso internacional.

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

_strtime, _wstrtime, _strtime_s, _wstrtime_s

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

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

tempo, _time32, _time64

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

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

_tzset

Variáveis de tempo externos ajustados da variável de tempo TZdo ambiente.

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

_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64

Definir o tempo de alteração para o arquivo especificado usando a hora atual ou o valor de tempo armazenados na estrutura.

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

Dica

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 de tempo retorna a hora atual como o número de segundos decorridos desde meia-noite o 1º de janeiro de 1970.Na versão 7,0 do Microsoft C/C++, time retornou a hora atual à medida que o número de segundos decorridos desde meia-noite o 31 de dezembro de 1899.

Dica

Em versões de Visual C++ e Microsoft C/C++ antes do Visual C++ 2005, time_t foi long int (32 bits) e portanto não pode ser usado para datas após 3:14: 7 de janeiro de 19, 2038, UTC.time_t agora é equivalente a __time64_t por padrão, mas definir _USE_32BIT_TIME_T altera time_t a __time32_t e força muitas funções de hora para chamar as versões que têm time_tde 32 bits.Para obter mais informações, consulte Tipos padrão e comentários na documentação das funções de hora individuais.

Consulte também

Referência

Rotinas de tempo de execução por categoria