Partilhar via

_strtime, _wstrtime

  • Artigo

Copia o tempo para um buffer. Versões mais seguras dessas funções estão disponíveis; confira _strtime_s, _wstrtime_s.

Sintaxe

char *_strtime(
   char *timestr
);
wchar_t *_wstrtime(
   wchar_t *timestr
);
template <size_t size>
char *_strtime(
   char (&timestr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrtime(
   wchar_t (&timestr)[size]
); // C++ only

Parâmetros

timestr
Cadeia de caracteres de hora.

Valor retornado

Retorna um ponteiro para a cadeia de caracteres resultante timestr.

Comentários

A _strtime função copia a hora local atual para o buffer apontado por timestr. A hora é formatada como hh:mm:ss, onde hh são dois dígitos que representam a hora em notação de 24 horas. mm é de dois dígitos para os minutos após a hora e ss é de dois dígitos para segundos. Por exemplo, a cadeia de caracteres 18:23:44 representa 23 minutos e 44 segundos após as 18h. O buffer deve ter pelo menos 9 bytes de comprimento.

_wstrtime é uma versão de caractere largo de _strtime; o argumento e o valor retornado de _wstrtime são cadeias de caracteres largos. Caso contrário, essas funções se comportam de forma idêntica. Se timestr for um NULL ponteiro ou se timestr estiver formatado incorretamente, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a exceção tiver permissão para continuar, essas funções retornarão um NULL, e definido errno como EINVAL if timestr was a NULL ou definido errno como ERANGE if timestr está formatado incorretamente.

No C++, essas funções têm sobrecargas de modelo que invocam os equivalentes mais novos e seguros dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H _UNICODE e _MBCS não definidos _MBCS definido _UNICODE definido
_tstrtime _strtime _strtime _wstrtime

Requisitos

Rotina Cabeçalho necessário
_strtime <time.h>
_wstrtime <time.h> ou <wchar.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_strtime.c
// compile with: /W3

#include <time.h>
#include <stdio.h>

int main( void )
{
   char tbuffer [9];
   _strtime( tbuffer ); // C4996
   // Note: _strtime is deprecated; consider using _strtime_s instead
   printf( "The current time is %s \n", tbuffer );
}

The current time is 14:21:44

Confira também

Gerenciamento de tempo
asctime, _wasctime
ctime, _ctime32, _ctime64, _wctime, _wctime32, , _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset