閱讀英文

共用方式為


_strdate, _wstrdate

將目前的系統日期複製到緩衝區。 這些函式已有更安全的版本可用,請參閱 _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 個位元組。

如果 datestrNULL指標,則會叫用無效的參數處理程式,如參數驗證中所述。 如果允許繼續執行,這些函式會傳回 -1,並將 errno 設為 EINVAL

_wstrdate_strdate 的寬字元版本,_wstrdate 的引數與傳回值是寬字元字串。 除此之外,這些函式的行為相同。

在 C++ 中,這些函式具有樣板多載,可以叫用這些函式的更新且安全的對應版本。 如需詳細資訊,請參閱安全範本多載

根據預設,此函式的全域狀態會限定於應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態

一般文字常式對應

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
}
OS date: 04/25/03

另請參閱

時間管理
asctime, _wasctime
ctime、、_ctime32_ctime64_wctime、、_wctime32_wctime64
gmtime、 、 _gmtime32_gmtime64
localtime、 、 _localtime32_localtime64
mktime、 、 _mktime32_mktime64
time、 、 _time32_time64
_tzset