_strtime, _wstrtime

Articolo
06/09/2015

Copia il tempo in un buffer. Sono disponibili versioni più sicure di queste funzioni. 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
Stringhe orarie

Valore restituito

Restituisce un puntatore alla stringa di caratteri risultante timestr.

Note

La funzione di _strtime copia l'ora locale corrente nel buffer puntato da timestr*.* Il tempo viene formattato come hh:mm:ss in cui hh è composto da 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 pomeriggio Il buffer deve essere lungo almeno 9 byte.

_wstrtime è una versione a caratteri estesi di _strtime; gli argomenti e i valori restituiti di _wstrtime sono stringhe con caratteri estesi. Queste funzioni si comportano in modo identico in caso contrario. Se timestr è un puntatore NULL 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 un valore NULL e un set errno a EINVAL se timestr è un oggetto NULL o un set errno a ERANGE se timestr è formattato in modo non corretto.

In C++, queste funzioni presentano overload dei modelli che richiamano le relative controparti sicure e più recenti. Per ulteriori informazioni, vedere Overload di modelli sicuri.

Mapping di routine di testo generico

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

Requisiti

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

Per ulteriori informazioni sulla compatibilità, 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 );
}