_strtime, _wstrtime

Copia l'ora in un buffer. Sono disponibili versioni più sicure di queste funzioni; vedere _strtime_s, _wstrtime_s.

Sintassi

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.

Osservazioni:

La _strtime funzione copia l'ora locale corrente nel buffer a timestrcui punta . L'ora viene formattata come hh:mm:ss, dove hh è costituito da due cifre che rappresentano l'ora nella notazione di 24 ore. mm è costituito da due cifre per i minuti trascorsi l'ora e ss sono due cifre per i secondi. Ad esempio, la stringa 18:23:44 rappresenta 23 minuti e 44 secondi dopo le 16.00. Il buffer deve avere una lunghezza di almeno 9 byte.

_wstrtime è una versione a caratteri wide di _strtime. L'argomento e il valore restituito di _wstrtime sono stringhe a caratteri wide. A parte ciò, queste funzioni si comportano in modo identico. Se timestr è un NULL puntatore o se timestr è formattato in modo non corretto, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'eccezione può continuare, queste funzioni restituiscono un NULLoggetto e impostano su se è o NULL impostato errnoEINVAL su ERANGEerrno se timestrtimestr è formattato in modo non corretto.

In C++ queste funzioni presentano overload di modello che richiamano le relative controparti più recenti e sicure. Per altre informazioni, vedere Proteggere gli overload dei modelli.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

Routine TCHAR.H	_UNICODE e _MBCS non definito	_MBCS Definito	_UNICODE Definito
_tstrtime	_strtime	_strtime	_wstrtime

Requisiti

Ciclo	Intestazione obbligatoria
_strtime	<time.h>
_wstrtime	<time.h> o <wchar.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

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

The current time is 14:21:44

Vedi anche

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