_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 个字符。

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