_strtime, _wstrtime

Artigo
06/09/2015

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

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 tempo.

Valor de retorno

Retorna um ponteiro para a cadeia de caracteres resultante timestr.

Comentários

A função de _strtime copia a hora local atual no buffer apontado por timestr*.* A hora é formatada como hh:mm:ss onde hh são dois dígitos que representam a hora na notação de 24 horas, mm são dois dígitos que representam os minutos depois da hora, e ss são dois dígitos que representam segundos. Por exemplo, a cadeia de caracteres 18:23:44 representa 23 minutos e 44 segundos depois de 6 PM. O buffer deve ser pelo menos 9 bytes.

_wstrtime é uma versão de ampla caractere de _strtime; o argumento e o valor de retorno de _wstrtime são cadeias de caracteres de ampla caractere. Essas funções se comportam idêntica de outra forma. Se timestr é ponteiro de NULL ou se estiver timestr formatadas incorretamente, o manipulador inválido do parâmetro será chamado, conforme descrito em Validação do parâmetro. Se a exceção é permitida continuar, essas funções retornam NULL e um conjunto errno a EINVALtimestr se fosse um NULL ou um conjunto errno a ERANGE se timestr é formatadas incorretamente.

No C++, essas funções têm as sobrecargas de modelo que invocam as correspondentes seguras mais recentes dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Mapeamentos da rotina de texto genérico

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

Requisitos

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

Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.

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 );
}