_strtime、_wstrtime
复制时间到缓冲区。 提供这些函数的更多安全版本;请参见 _strtime_s、_wstrtime_s。
char *_strtime(
char *timestr
);
wchar_t *_wstrtime(
wchar_t *timestr
);
template <size_t size>
char *_strtime(
char (×tr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrtime(
wchar_t (×tr)[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 );
}
.NET Framework 等效项
请参见
参考
ctime、_ctime32、_ctime64、_wctime、_wctime32、_wctime64