strftime, wcsftime, _strftime_l_wcsftime_l

Formatta una stringa dell'ora.

Sintassi

size_t strftime(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr
);
size_t _strftime_l(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr,
   _locale_t locale
);
size_t wcsftime(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr
);
size_t _wcsftime_l(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr,
   _locale_t locale
);

Parametri

strDest
Stringa di output.

maxsize
Dimensioni del buffer strDest, in caratteri (char o wchar_t).

format
Stringa di controllo del formato.

timeptr
Struttura di dati tm.

locale
Impostazioni locali da usare.

Valore restituito

strftime restituisce il numero di caratteri in strDest e wcsftime restituisce il numero di caratteri wide corrispondente.

Se il numero totale di caratteri, incluso il carattere di terminazione Null, è maggiore di maxsize, sia strftime che wcsftime restituiscono 0 e il contenuto di strDest è indeterminato.

Il numero di caratteri in strDest è uguale al numero di caratteri letterali in format, più tutti i caratteri che possono essere aggiunti a format tramite codici di formattazione. Il valore null di terminazione di una stringa non viene conteggiato nel valore restituito.

Osservazioni:

Le strftime funzioni e wcsftime formattano il tm valore dell'ora in in timeptr base all'argomento fornito format e archiviano il risultato nel buffer strDest. Nella stringa vengono inseriti al massimo maxsize. Per una descrizione dei campi nella timeptr struttura, vedere asctime. wcsftime è l'equivalente di caratteri wide di strftime. L'argomento puntatore di stringa corrispondente punta a una stringa di caratteri wide. A parte ciò, queste funzioni si comportano in modo identico.

Questa funzione convalida i relativi parametri. Se strDest, formato timeptr è un puntatore Null o se la tm struttura dei dati indirizzata da timeptr non è valida (ad esempio, se contiene valori di intervallo non validi per l'ora o la data) o se la format stringa contiene un codice di formattazione non valido, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce 0 e imposta errno su EINVAL.

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

L'argomento format è costituito da uno o più codici. Come in printf, i codici di formattazione sono preceduti da un segno di percentuale (%). I caratteri che non iniziano con % vengono copiati senza modifiche in strDest. La categoria LC_TIME delle impostazioni locali correnti influisce sulla formattazione dell'output di strftime. Per altre informazioni su LC_TIME, vedere setlocale.) Le strftime funzioni e wcsftime usano le impostazioni locali attualmente impostate. Le _strftime_l versioni e _wcsftime_l di queste funzioni sono identiche, ad eccezione del fatto che accettano le impostazioni locali come parametro e lo usano invece delle impostazioni locali attualmente impostate. Per altre informazioni, vedere Locale.

Le strftime funzioni supportano questi codici di formattazione:

Come nella funzione printf, il flag # può essere usato come prefisso per qualsiasi codice di formattazione. In questo caso, il significato del codice di formato viene modificato come segue.

L'anno basato su settimana e settimana ISO 8601 prodotto da %V, %ge %Gusa una settimana che inizia il lunedì. La settimana 1 è la settimana che contiene il quarto giorno di gennaio, ovvero la prima settimana che include almeno quattro giorni dell'anno. Se il primo lunedì dell'anno è il 2°, il terzo o il 4° giorno, i giorni precedenti fanno parte dell'ultima settimana dell'anno precedente. Per questi giorni, %V viene sostituito da 53 ed entrambi e %g %G vengono sostituiti dalle cifre dell'anno precedente.

Requisiti

Le _strftime_l funzioni e _wcsftime_l sono specifiche di Microsoft. Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

Vedere l'esempio per time.

Vedi anche

impostazioni locali
Gestione orari
Manipolazione delle stringhe
localeconv
setlocale, _wsetlocale
Funzioni strcoll
strxfrm, wcsxfrm, _strxfrm_l_wcsxfrm_l