_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，并且将 errno 设置为 EINVAL（如果 timestr 是 NULL），或将 errno 设置为 ERANGE（如果 timestr 格式不正确）。

在 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