_strtime, _wstrtime

Artigo
08/25/2010

Copie o time para um buffer.Versões mais seguras dessas funções estão disponível; 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
Seqüência de caracteres de time.

Valor de retorno

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

Comentários

The _strtime função copia a time local corrente para o buffer apontado por timestr*.* O time é formatado sistema autônomo hh:mm:ss onde hh é dois dígitos que representa a time em notação de 24 horas, mm é de dois dígitos que representa sistema autônomo minutos depois da time estabelecida, e ss é dois dígitos representando segundos. Por exemplo, a seqüência de caracteres 18:23:44 representa 23 minutos e 44 segundos após 6 horas O buffer deve ser pelo menos 9 bytes.

_wstrtime é uma versão de caractere largo da _strtime; valor de argumento e retornar _wstrtime são seqüências de caracteres largos. Essas funções tenham comportamento idêntico otherwise.If timestr é NULL ponteiro ou se timestr está formatado incorretamente, o inválido é chamado, o manipulador de parâmetro sistema autônomo descrito em Validação de parâmetro. Se a exceção for permitida para continuar, essas funções retornam um nulo e conjunto errno para EINVAL Se timestr foi um nulo ou conjunto errno para ERANGE Se timestr está formatado incorretamente.

No C++, essas funções têm sobrecargas de modelo que invocam as suas similares do mais recentes, seguras dessas funções.For more information, see Proteger overloads de modelo.

Mapeamentos de rotina de texto genérica

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 obter informações adicionais 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 );
}

The current time is 14:21:44