_strtime_s, _wstrtime_s

將目前的時間複製到緩衝區。 這些函式是 的版本 _strtime ， _wstrtime 具有 CRT 中安全性功能中所述 的安全性增強功能。

語法

errno_t _strtime_s(
   char *buffer,
   size_t numberOfElements
);
errno_t _wstrtime_s(
   wchar_t *buffer,
   size_t numberOfElements
);
template <size_t size>
errno_t _strtime_s(
   char (&buffer)[size]
); // C++ only
template <size_t size>
errno_t _wstrtime_s(
   wchar_t (&buffer)[size]
); // C++ only

參數

buffer
長度至少為 10 個位元組的緩衝區內會寫入時間。

numberOfElements
緩衝區的大小。

傳回值

如果成功，則為零。

如果發生錯誤狀況，則會叫用不正確參數處理常式，如參數驗證 中所述 。 如果失敗，傳回值就是錯誤碼。 錯誤碼在 EERRNO.H 中定義，請參閱下表查看此函式產生的確切錯誤。 如需錯誤碼的詳細資訊，請參閱 errno 常數 。

錯誤條件

buffer	numberOfElements	傳回	buffer 的內容。
NULL	(任何)	EINVAL	未修改
不是 NULL (指向有效的緩衝區)	0	EINVAL	未修改
不是 NULL (指向有效的緩衝區)	0 < 大小 < 9	EINVAL	空字串
不是 NULL (指向有效的緩衝區)	大小 > 9	0	目前的時間格式一如＜備註＞所指定

安全性問題

如果參數大於 9，傳入不正確非 NULL 值，則會導致存取違規 numberOfElements 。

傳遞大於緩衝區實際大小的 numberOfElements 值會造成緩衝區滿溢。

備註

這些函式提供 _strtime 和 _wstrtime 的更安全版本。 函 _strtime_s 式會將目前的當地時間複製到 所指向的 buffer 緩衝區。 時間會格式化為 hh：mm：ss ，其中 hh 兩位數代表 24 小時標記法中的小時， mm 是代表小時過去分鐘數的兩位數，而 ss 是代表秒數的兩位數。 例如，字串 18：23：44 代表下午 6 點之後的 23 分 44 秒。緩衝區長度必須至少為 9 個位元組;實際大小是由第二個參數指定。

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

C++ 利用多載樣板簡化了這些函式的使用方式。多載可自動推斷緩衝區長度 (因而不須指定大小引數)，也可以將不安全的舊函式自動取代成較新且安全的對應函式。 如需詳細資訊，請參閱 保護範本多載 。

這些函式的偵錯程式庫版本會先將緩衝區填入0xFE。 若要停用此行為，請使用 _CrtSetDebugFillThreshold 。

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

泛型文字常式對應

TCHAR.H 常式	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_tstrtime_s	_strtime_s	_strtime_s	_wstrtime_s

需求

常式	必要的標頭
_strtime_s	<time.h>
_wstrtime_s	<time.h > 或 < wchar.h>

如需相容性詳細資訊，請參閱相容性。

範例

// strtime_s.c

#include <time.h>
#include <stdio.h>

int main()
{
    char tmpbuf[9];
    errno_t err;

    // 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();

    // Display operating system-style date and time.
    err = _strtime_s( tmpbuf, 9 );
    if (err)
    {
       printf("_strdate_s failed due to an invalid argument.");
      exit(1);
    }
    printf( "OS time:\t\t\t\t%s\n", tmpbuf );
    err = _strdate_s( tmpbuf, 9 );
    if (err)
    {
       printf("_strdate_s failed due to an invalid argument.");
       exit(1);
    }
    printf( "OS date:\t\t\t\t%s\n", tmpbuf );

}

OS time:            14:37:49
OS date:            04/25/03

另請參閱

時間管理
asctime_s, _wasctime_s
ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s
gmtime_s, _gmtime32_s, _gmtime64_s
localtime_s, _localtime32_s, _localtime64_s
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset