_strdate, _wstrdate

Articolo
06/09/2015

Copiare la data di sistema corrente in un buffer. Sono disponibili versioni più sicure di queste funzioni. Vedere _strdate_s, _wstrdate_s.

char *_strdate(
   char *datestr 
);
wchar_t *_wstrdate(
   wchar_t *datestr 
);
template <size_t size>
char *_strdate(
   char (&datestr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrdate(
   wchar_t (&datestr)[size]
); // C++ only

Parametri

datestr
Un puntatore a un buffer che contiene la stringa della data formattata.

Valore restituito

Ognuna di queste funzioni restituisce un puntatore alla stringa datestr di caratteri risultante.

Note

Sono disponibili versioni più sicure di queste funzioni; vedere _strdate_s, _wstrdate_s. Si consiglia di usare le versioni più sicure delle funzioni dove possibile.

La funzione _strdate copia la data di sistema corrente nel buffer puntato da datestr, nel formato mm/dd/yy, dove mm sono le due cifre che rappresentano il mese, dd sono le due cifre che rappresentano il giorno e yy sono le ultime due cifre dell'anno. Ad esempio, la stringa 12/05/99 rappresenta il 5 dicembre 1999. Il buffer deve essere lungo almeno 9 byte.

Se datestr è un NULL puntatore null, viene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno su EINVAL.

_wstrdate è una versione a caratteri estesi di _strdate; gli argomenti e i valori restituiti di _wstrdate sono stringhe con caratteri estesi. Altrimenti queste funzioni si comportano in modo identico.

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
_tstrdate	_strdate	_strdate	_wstrdate

Requisiti

Routine	Intestazione obbligatoria
_strdate	<time.h>
_wstrdate	<time.h> o <wchar.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'Introduzione.

Esempio

// strdate.c
// compile with: /W3
#include <time.h>
#include <stdio.h>
int main()
{
    char tmpbuf[9];
   
    // Set time zone from TZ environment variable. If TZ is not set,
    // the operating system is queried to obtain the default value 
    // for the variable. 
    //
    _tzset();

    printf( "OS date: %s\n", _strdate(tmpbuf) ); // C4996
    // Note: _strdate is deprecated; consider using _strdate_s instead
}