_strdate， _wstrdate

项目
04/10/2013

复制当前系统日期到缓冲区。这些功能的更安全版本可用; _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

参数

datestr
对包含已格式化的日期字符串缓冲区的指针。

返回值

这些函数都返回一个指针对结果的字符串。 datestr。

备注

这些功能的更安全版本可用; _strdate_s， _wstrdate_s参见。建议在可能的情况下使用较安全的功能。

_strdate 功能复制当前系统日期到缓冲区指向由 datestr，设置的 mm/dd/yy，其中 mm 是表示月份的两位数， dd 是表示日的两个数字，因此， yy 是中的前两个数字。例如，字符串 12/05/99 表示 1999 年十二月 5 日。缓冲区长度必须至少为 9 字节。

如果 datestr 是 NULL 指针，无效参数调用处理程序，如参数验证所述。如果执行允许继续，这些函数返回 -1 并将 errno 到 EINVAL。

_wstrdate 是 _strdate的宽字符版本;参数和返回 _wstrdate 的值是宽字符字符串。这些功能否则具有相同的行为。

在 C++ 中，这些函数的调用的模板重载越+新，保证这些函数副本。有关更多信息，请参见安全模板重载。

一般文本例程映射

TCHAR.H 实例	未定义的 _UNICODE _MBCS	定义的 _MBCS	定义的 _UNICODE
_tstrdate	_strdate	_strdate	_wstrdate

要求

实例	必需的头
_strdate	time.h
_wstrdate	time.h 或 wchar.h

有关其他的兼容性信息，请参见中介绍的兼容性。

示例

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