_strtime, _wstrtime

Articolo
03/26/2013

Copiare il tempo a un buffer.Più versioni sicure di queste funzioni sono disponibili, vedere _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

Parametri

timestr
Stringa dell'ora.

Valore restituito

Restituisce un puntatore alla stringa di caratteri risultante timestr.

Note

_strtime la funzione copia l'ora locale corrente nel buffer puntato in near timestr*.* Il tempo viene formattato come hh:mm:ss dove hh sono due cifre che rappresentano l'ora in notazione di 24 ore, mm sono due cifre che rappresentano i minuti dopo l'ora e ss sono due cifre che rappresentano i secondi.Ad esempio, la stringa 18:23:44 rappresenta 23 minuti e 44 secondi dopo le 6 del pomeriggioil buffer deve essere almeno di 9 byte di lunghezza.

_wstrtime è una versione a caratteri estesi di _strtime; l'argomento e il valore restituito di _wstrtime sono le stringhe di caratteri estesi.Queste funzioni si comportano in modo identico in caso contrario. se timestr viene NULL puntatore o se timestr viene formattato in modo corretto, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'eccezione è consentita per continuare, queste funzioni restituiscono NULL e impostate errno in EINVAL se timestr è NULL o un set errno in ERANGE se timestr è formattato in modo non corretto.

In C++, queste funzioni presentano overload del modello da richiamare le più recenti, controparti sicure di queste funzioni.Per ulteriori informazioni, vedere Assicurarsi che gli overload del modello.

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tstrtime	_strtime	_strtime	_wstrtime

Requisiti

routine	Intestazione di associazione
_strtime	<time.h>
_wstrtime	<time.h> o <wchar.h>

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Esempio

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