_strdate, _wstrdate

Copie a data atual do sistema para um buffer. Versões mais seguras dessas funções estão disponíveis; confira _strdate_s, _wstrdate_s.

Sintaxe

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 retornado

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

Comentários

Versões mais seguras dessas funções estão disponíveis; confira _strdate_s, _wstrdate_s. Recomenda-se que as funções mais seguras sejam usadas sempre que possível.

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

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

_wstrdate é uma versão de caractere largo de _strdate; o argumento e o valor retornado de _wstrdate são cadeias de caracteres largos. Caso contrário, essas funções se comportam de forma idêntica.

No C++, essas funções têm sobrecargas de modelo que invocam os equivalentes mais novos e seguros dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H	_UNICODE e _MBCS não definidos	_MBCS 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 sobre compatibilidade, consulte Compatibilidade.

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
}

OS date: 04/25/03

Confira também

Gerenciamento de tempo
asctime, _wasctime
ctime, _ctime32, _ctime64, _wctime, _wctime32, , _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset