_strdate, _wstrdate

Copient la date système actuelle dans une mémoire tampon. Des versions plus sécurisées de ces fonctions sont disponibles ; voir _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 ; voir _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 Surcharges de modèles sécurisés.

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 routine de texte générique

Routine TCHAR.H	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_tstrdate	_strdate	_strdate	_wstrdate

Spécifications

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

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, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset