_strdate, _wstrdate

Copia la fecha actual del sistema en un búfer. Hay disponibles versiones más seguras de estas funciones; consulte _strdate_s, _wstrdate_s.

Sintaxis

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

Parámetros

datestr
Puntero a un búfer que contiene la cadena de fecha con formato.

Valor devuelto

Cada una de estas funciones devuelve un puntero a la cadena de caracteres resultante datestr.

Comentarios

Hay disponibles versiones más seguras de estas funciones; consulte _strdate_s, _wstrdate_s. Se recomienda usar las funciones más seguras siempre que sea posible.

La _strdate función copia la fecha actual del sistema en el búfer a datestrla que apunta , con formato mm/dd/aaaa, donde mm es dos dígitos que representan el mes, dd es dos dígitos que representan el día y yy es los dos últimos dígitos del año. Por ejemplo, la cadena 12/05/99 representa el 5 de diciembre de 1999. La longitud del búfer debe ser de 9 bytes como mínimo.

Si datestr es un NULL puntero, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, estas funciones devuelven -1 y establecen errno en EINVAL.

_wstrdate es una versión con caracteres anchos de _strdate; el argumento y el valor devuelto de _wstrdate son cadenas de caracteres anchos. Por lo demás, estas funciones se comportan exactamente igual.

En C++, estas funciones tienen sobrecargas de plantilla que invocan los homólogos seguros más recientes de estas funciones. Para obtener más información, consulte Sobrecargas de plantillas seguras.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tstrdate	_strdate	_strdate	_wstrdate

Requisitos

Routine	Encabezado necesario
_strdate	<time.h>
_wstrdate	<time.h> o <wchar.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

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

Consulte también

Administración de tiempo
asctime, _wasctime
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset