_strdate、_wstrdate

發行項
06/09/2015

複製目前系統日期至緩衝區。這些函式已有更安全的版本可用，請參閱 _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
}