_strdate, _wstrdate

Artigo
02/25/2013

Copie a data atual do sistema para um buffer.Versões mais seguras dessas funções estão disponíveis; see _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 seqüência de caracteres de data formatada.

Valor de retorno

Cada uma dessas funções retorna um ponteiro para a seqüência de caracteres resultante datestr.

Comentários

Versões mais seguras dessas funções estão disponíveis; consulte _strdate_s, _wstrdate_s.É recomendável que as funções mais seguras seja usado sempre que possível.

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

Se datestr é um NULL o ponteiro, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, essas funções retornam -1 e defina errno para EINVAL.

_wstrdateé uma versão de caractere largo de _strdate; o valor de argumento e o retorno de _wstrdate são seqüências de caracteres largos.Essas funções se comportam exatamente caso contrário.

No C++, essas funções têm sobrecargas de modelo que invocam as suas similares do mais recentes, seguras dessas funções.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo definido	_ Unicode definido
_tstrdate	_strdate	_strdate	_wstrdate

Requisitos

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

Para obter 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
}