_strdate, _wstrdate

Artículo
04/10/2013

Copie la fecha actual del sistema a un búfer.Versiones más seguras de estas funciones están disponibles; vea _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

Parámetros

datestr
Un 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

Versiones más seguras de estas funciones están disponibles; vea _strdate_s, _wstrdate_s.Se recomienda que las funciones más seguras se utilicen siempre que sea posible.

La función de _strdate copia la fecha actual del sistema en el búfer indicada por datestr, mmcon formato/dd/yy, donde dos dígitos mm 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.El búfer debe ser por lo menos 9 bytes de longitud.

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

_wstrdate es una versión con caracteres anchos de _strdate; el argumento y el valor devuelto de _wstrdate son cadenas de caracteres.Estas funciones se comportan exactamente igual de otra manera.

En C++, estas funciones tienen sobrecargas de plantilla que se invoque según el nuevo, garantiza que sus homólogos de estas funciones.Para obtener más información, vea Sobrecargas de plantilla de seguridad.

Asignaciones de la rutina de texto genérico

rutina de TCHAR.H	_UNICODE y _MBCS no definido	_MBCS definido	_UNICODE definido
_tstrdate	_strdate	_strdate	_wstrdate

Requisitos

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

Para obtener información adicional de compatibilidad, vea compatibilidad en la Introducción.

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
}