_strtime, _wstrtime

將時間複製到緩衝區。 這些函式已有更安全的版本可用，請參閱 _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，如果 設定為 ，則設定errnoEINVAL為 NULL ，如果 timestr timestr 格式不正確，則設定errnoERANGE為 。

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

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

一般文字常式對應

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 );
}

The current time is 14:21:44

另請參閱

時間管理
asctime, _wasctime
ctime、、_ctime32_ctime64、_wctime、、_wctime32、_wctime64
gmtime、 、 _gmtime32_gmtime64
localtime、 、 _localtime32_localtime64
mktime、 、 _mktime32_mktime64
time、 、 _time32_time64
_tzset