_strdate, _wstrdate

Article
06/09/2015

Copie la date système actuelle vers une mémoire tampon. Des versions plus sécurisées de ces fonctions sont disponibles ; consultez _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

Paramètres

datestr
Un pointeur vers une mémoire tampon qui contient la chaîne de dates formatées.

Valeur de retour

Chacune de ces fonctions retournent un pointeur vers la chaine de caractère résultantedatestr.

Notes

Des versions plus sécurisées de ces fonctions sont disponibles ; consultez 585kfedd(v=vs.120).md. Il est recommandé que des fonctions plus sécurisées soient utilisées dans la mesure du possible.

La fonction _strdate copie la date système actuelle vers la mémoire tampon désignée par le pointeur datestr, mise sous la forme mm/dd/yy, où les deux chiffres mm représentent le mois, les chiffres dd représentent le jour, et les deux chiffresyysont les deux derniers chiffres de l'année. Par exemple, la chaîne 12/05/99 représente le le 5 décembre 1999. La mémoire tampon doit etre longue d'au moins 9 octets.

Si datestr est un pointeur NULL, le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, ces fonctions retournent -1 et attribuent à errno la valeur EINVAL.

_wstrdate est une version caractères larges de _strdate; l'argument et la valeur de retour de _wstrdate sont des chaînes de caractères larges. Ces fonctions se comportent sinon de façon identique.

En C++, ces fonctions ont des surcharges de modèle qui appellent les équivalents plus récents et sécurisés de ces fonctions. Pour plus d'informations, consultez Sécuriser les surcharges de modèle.

Mappages de routines de texte générique

Routine TCHAR.H	_UNICODE & _MBCS non définis	_MBCS défini	_UNICODE défini
_tstrdate	_strdate	_strdate	_wstrdate

Configuration requise

Routine	En-tête requis
_strdate	<time.h>
_wstrdate	<time.h> or <wchar.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

Exemple

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