_strdate, _wstrdate

Artigo
06/09/2015

Data atual do sistema de cópia em um buffer. Versões mais seguras dessas funções estão disponíveis; consulte _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
Um ponteiro para um buffer que contém a cadeia de caracteres de data formatada.

Valor de retorno

Cada uma dessas funções retorna um ponteiro para a cadeia de caracteres resultante datestr.

Comentários

Versões mais seguras dessas funções estão disponíveis; consulte _strdate_s, _wstrdate_s. É recomendado que o mais seguro as funções são usadas onde for possível.

A função de _strdate copia a data atual do sistema ao buffer apontado por datestr, formatada mm/dd/yy, onde mm são dois dígitos que representam o mês, dd são dois dígitos que representam o dia, e yy é os últimos dois dígitos do ano. Por exemplo, a cadeia de caracteres 12/05/99 representa o 5 de dezembro de 1999. O buffer deve ser pelo menos 9 bytes.

Se datestr é um ponteiro NULL, o parâmetro de manipulador inválido é invocado, como descrito em Validação do parâmetro. Se a execução puder continuar, essas funções retornarão -1 e definirão errno a EINVAL.

_wstrdate é uma versão de ampla caractere de _strdate; o argumento e o valor de retorno de _wstrdate são cadeias de caracteres de ampla caractere. Essas funções se comportam exatamente o contrário.

No C++, essas funções têm as sobrecargas de modelo que invocam as correspondentes seguras mais recentes dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tstrdate	_strdate	_strdate	_wstrdate

Requisitos

Rotina	Cabeçalho necessário
_strdate	<time.h>
_wstrdate	<time.h ou> wchar.h <>

Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

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