_strtime， _wstrtime

项目
04/10/2013

复制时就缓冲区。这些功能的更安全版本可用; _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 是表示以 24 小时表示形式的两位数字的小时数的 hh:mm:ss ， mm 是表示通过小时数的两位数字的分钟，并且， ss 是表示秒的两个数字。例如，字符串 18:23:44 表示 23 分钟 44 秒通过 6 PM。缓冲区长度必须至少为 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 );
}