_strtime、_wstrtime

發行項
06/09/2015

複製時間到緩衝區。這些函式已有更安全的版本可用，請參閱 _strtime_s、_wstrtime_s。

char *_strtime(
   char *timestr 
);
wchar_t *_wstrtime(
   wchar_t *timestr 
);
template <size_t size>
char *_strtime(
   char (&timestr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrtime(
   wchar_t (&timestr)[size]
); // C++ only

參數

timestr
時間字串

傳回值

傳回結果字元字串timestr的指標。

備註

_strtime 函式複製目前本地時間到緩衝區所指向的 timestr*。*時間會格式化為 hh:mm:ss，其中hh 是表示 24 小時制附註的二位數小時的，mm是代表透過小時的兩位數的分鐘，ss 是表示秒數的兩個數字。例如， 18:23:44 字串表示下午 6 點 23 分 44 秒。緩衝區的長度必須至少是 9 個位元組。

_wstrtime 是 _strtime 的寬字元版本，_wstrtime 函式的參數和回傳值是寬字元字串。這些函式另有相同的行為。如果 timestr 是 NULL 指標，或 timestr 的格式不正確，無效的參數叫用處理常式，如參數驗證中所述。如果例外狀況允許繼續執行，這些函式會傳回 NULL 並將 errno 設為 EINVAL ，如果 timestr 為 null 或將 errno 設為 ERANGE ，如果 timestr 格式不正確。

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

一般文字常式對應

TCHAR.H 常式	_UNICODE &_MBCS 未定義	_MBCS 已定義	_UNICODE 已定義
_tstrtime	_strtime	_strtime	_wstrtime

需求

常式	必要的標頭
_strtime	<time.h>
_wstrtime	<time.h> 或 <wchar.h>

如需其他相容性資訊，請參閱＜簡介＞中的相容性。

範例

// crt_strtime.c
// compile with: /W3

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

int main( void )
{
   char tbuffer [9];
   _strtime( tbuffer ); // C4996
   // Note: _strtime is deprecated; consider using _strtime_s instead
   printf( "The current time is %s \n", tbuffer );
}