_strtime, _wstrtime

Artigo
02/25/2013

O tempo para um buffer de cópia.Versões mais seguras dessas funções estão disponíveis; see _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
Seqüência de caracteres de tempo.

Valor de retorno

Retorna um ponteiro para a seqüência de caracteres resultante timestr.

Comentários

O _strtime função copia a hora local atual para o buffer apontado por timestr*.* O tempo é formatado como hh:mm:ss onde hh é de dois dígitos que representa a hora na notação de 24 horas, mm é de dois dígitos que representa os minutos depois da hora, e ss é de dois dígitos que representa os segundos.Por exemplo, a seqüência de caracteres 18:23:44 representa 23 minutos e 44 segundos passados 6 P.M.O buffer deve ser pelo menos 9 bytes.

_wstrtimeé uma versão de caractere largo de _strtime; o valor de argumento e o retorno de _wstrtime são seqüências de caracteres largos.Essas funções se comportam exatamente caso contrário.Se timestr é NULL ponteiro ou se timestr está formatado incorretamente, inválido manipulador de parâmetro é chamado, conforme descrito em Validação de parâmetro.Se a exceção é permitida para continuar, essas funções de retorno nulo e o conjunto errno para EINVAL se timestr foi um valor nulo ou definir errno para ERANGE se timestr não está formatada corretamente.

No C++, essas funções têm sobrecargas de modelo que invocam as suas similares do mais recentes, seguras dessas funções.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo 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 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 );
}