_strtime _wstrtime

發行項
03/15/2013

複製到緩衝區的時間。這些函式更安全版本都可使用; see _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代表 23 分 44 秒過 6 P.M.緩衝區的大小必須至少 9 個位元組長。

_wstrtime寬字元版本的_strtime。引數和傳回值的_wstrtime是寬字元字串。這些函式具有相同其他方式作業。如果timestr是NULL指標或timestr的格式不正確，不正確的參數處理常式會叫用，如所述參數驗證。如果例外狀況則允許繼續執行，這些函式傳回 null 值和集合errno到EINVAL如果timestr是空值或設定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 );
}