_strdate, _wstrdate

Copient la date système actuelle dans une mémoire tampon. Des versions plus sécurisées de ces fonctions sont disponibles. Consultez _strdate_s, _wstrdate_s.

Syntaxe

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
Pointeur désignant une mémoire tampon contenant la chaîne de date mise en forme.

Valeur retournée

Chacune de ces fonctions retourne un pointeur désignant la chaîne de caractères datestr obtenue.

Notes

Des versions plus sécurisées de ces fonctions sont disponibles. Consultez _strdate_s, _wstrdate_s. Il est recommandé d’utiliser les fonctions plus sécurisées autant que possible.

La _strdate fonction copie la date système actuelle vers la mémoire tampon pointée par datestr, mise en forme mm/dd/aaaa, où mm est deux chiffres représentant le mois, dd est deux chiffres représentant le jour, et yy est les deux derniers chiffres de l’année. Par exemple, la chaîne 12/05/99 représente le 5 décembre 1999. La mémoire tampon doit avoir une longueur au moins égale à 9 octets.

S’il datestr s’agit d’un NULL pointeur, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l'exécution est autorisée à se poursuivre, ces fonctions retournent -1 et définissent errno avec 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 à 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.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routines de texte générique

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

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
}

OS date: 04/25/03

Voir aussi

Gestion des horaires
asctime, _wasctime
ctime, , _ctime32, _wctime_ctime64, , _wctime32_wctime64
gmtime, , _gmtime32_gmtime64
localtime, , _localtime32_localtime64
mktime, , _mktime32_mktime64
time, , _time32_time64
_tzset