_strdate_s, _wstrdate_s

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Copie la fecha actual del sistema en un búfer. Estas son versiones de _strdate, _wstrdate con mejoras de seguridad, como se describe en características de seguridad de CRT.

errno_t _strdate_s(  
   char *buffer,  
   size_t numberOfElements  
);  
errno_t _wstrdate_s(  
   wchar_t *buffer,  
   size_t numberOfElements  
);  
template <size_t size>  
errno_t _strdate_s(  
   char (&buffer)[size]  
); // C++ only  
template <size_t size>  
errno_t _wstrdate_s(  
   wchar_t (&buffer)[size]  
); // C++ only  

Parámetros

[out] buffer
Un puntero a un búfer que se rellenará con la cadena de fecha con formato.

[in] numberOfElements
Tamaño del búfer.

Cero si es correcta. El valor devuelto es un código de error si se produce un error. Códigos de error se definen en ERRNO. H; Consulte la tabla siguiente para exacta de los errores generados por esta función. Para obtener más información sobre códigos de error, consulte errno.

buffernumberOfElementsVolverContenido de buffer
NULL(any)EINVALNo modificado
No NULL (que señala al búfer válido)0EINVALNo modificado
No NULL (que señala al búfer válido)0 < numberOfElements < 9EINVALCadena vacía
No NULL (que señala al búfer válido)numberOfElements >= 90Fecha actual con el formato especificado en la sección de comentarios

Pasar a un no válido no NULL el valor de búfer se produce una infracción de acceso cuando el numberOfElements parámetro es mayor que 9.

Pasar valores de tamaño que es mayor que el tamaño real de la buffer dará como resultado de la saturación del búfer.

Estas funciones proporcionan versiones más seguras de _strdate y _wstrdate. El _strdate_s función copia la fecha del sistema actual en el búfer señalado por buffer, con el formato mm / dd / yy, donde mm es que representa el mes de dos dígitos dd es que representa el día de dos dígitos 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 tener al menos 9 caracteres.

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

Si buffer es una NULL puntero, o si numberOfElements es inferior a 9 caracteres, se invoca el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, estas funciones devuelven -1 y establezca errno a EINVAL si el búfer es NULL o si numberOfElements es menor o igual que 0, o un conjunto errno a ERANGE si numberOfElements es inferior a 9.

En C++, el uso de estas funciones se simplifica con las sobrecargas de plantilla; las sobrecargas pueden realizar una inferencia automáticamente de la longitud de búfer (lo que elimina el requisito de especificar un argumento de tamaño) y pueden reemplazar automáticamente funciones anteriores no seguras con sus homólogos seguros más recientes. Para obtener más información, consulta Secure Template Overloads.

Asignación de rutina de texto genérico:

Rutina TCHAR.H_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_tstrdate_s_strdate_s_strdate_s_wstrdate_s
RutinaEncabezado necesario
_strdate<time.h>
_wstrdate<time.h>o<wchar.h></wchar.h></time.h>
_strdate_s<time.h>

Vea el ejemplo de tiempo.

System::DateTime::Parse

Administración del tiempo
asctime_s, _wasctime_s
ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s
gmtime_s, _gmtime32_s, _gmtime64_s
localtime_s, _localtime32_s, _localtime64_s
mktime, _mktime32, _mktime64
tiempo, _time32, _time64
_tzset

Mostrar: