_strdate _wstrdate

發行項
03/15/2013

複製到緩衝區的目前系統日期。這些函式更安全版本都可使用; 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

參數

datestr
其中包含已格式化的日期字串的緩衝區指標。

傳回值

每個函式傳回產生的字元字串的指標datestr。

備註

這些函式更安全版本都可使用; 請參閱 _strdate_s、 _wstrdate_s。建議您盡可能使用更安全的函式。

_strdate函式所指向的緩衝區複製目前的系統日期datestr、格式化過mm/dd/yy，其中mm兩個數字代表月份， dd兩個數字代表日期，以及yy是一年的最後二位數。例如，字串12/05/99代表 1999 年 12 月 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
}