%>
将当前时间复制到缓冲区。 这些函数的版本是 _strtime、_wstrtime，具有安全性增强功能，如 CRT 中的安全功能中所述。
语法
errno_t _strtime_s(
char *buffer,
size_t numberOfElements
);
errno_t _wstrtime_s(
wchar_t *buffer,
size_t numberOfElements
);
template <size_t size>
errno_t _strtime_s(
char (&buffer)[size]
); // C++ only
template <size_t size>
errno_t _wstrtime_s(
wchar_t (&buffer)[size]
); // C++ only
参数
buffer
至少为 10 个字节长的缓冲区，将在其中写入时间。
numberOfElements
缓冲区的大小。
返回值
如果成功，则返回 0。
如果出现错误条件，则将调用无效的参数处理程序，如参数验证中所述。 如果失败，则返回值为错误代码。 错误代码在 ERRNO.H 中定义；有关此函数生成的确切错误，请参阅下表。 有关错误代码的详细信息，请参阅 errno 常数。
错误条件
buffer |
numberOfElements |
返回值 | buffer 的内容 |
|---|---|---|---|
NULL |
（任意数值） | EINVAL |
未修改 |
非 NULL（指向有效的缓冲区） |
0 | EINVAL |
未修改 |
非 NULL（指向有效的缓冲区） |
0 < size < 9 | EINVAL |
空字符串 |
非 NULL（指向有效的缓冲区） |
Size > 9 | 0 | 注解中指定的当前时间格式 |
安全问题
如果 numberOfElements 参数大于 9，则为缓冲区传入无效非 NULL 值将导致访问冲突。
为 numberOfElements 传递的值大于缓冲区的实际大小将导致缓冲区溢出。
注解
这些函数提供 _strtime 和 _wstrtime 的更安全的版本。 _strtime_s 函数将当前的本地时间复制到 buffer 所指向的缓冲区。 时间格式为 hh:mm:ss，其中 hh 是以 24 小时制表示小时的两位数，mm 是表示整点过的分钟数的两位数，ss 是表示秒的两位数。 例如，字符串 18:23:44 表示下午 6 点 23 分 44 秒。缓冲区必须至少为 9 个字节长；实际大小由第二个参数指定。
_wstrtime_s 是 _strtime_s 的宽字符版本；_wstrtime_s 的参数和返回值都是宽字符字符串。 否则这些函数具有相同行为。
在 C++ 中，使用这些函数由模板重载简化；重载可以自动推导出缓冲区长度 (不再需要指定大小自变量)，并且它们可以自动用以更新、更安全的对应物替换旧的、不安全的函数。 有关详细信息，请参阅安全模板重载。
这些函数的调试库版本首先用 0xFE 填充缓冲区。 若要禁用此行为，请使用 _CrtSetDebugFillThreshold。
默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。
一般文本例程映射
| TCHAR.H 例程 | _UNICODE 和 _MBCS 未定义 |
_MBCS 已定义 |
_UNICODE 已定义 |
|---|---|---|---|
_tstrtime_s |
_strtime_s |
_strtime_s |
_wstrtime_s |
要求
| 例程 | 必需的标头 |
|---|---|
_strtime_s |
<time.h> |
_wstrtime_s |
<time.h> 或 <wchar.h> |
有关兼容性的详细信息，请参阅 兼容性。
示例
// strtime_s.c
#include <time.h>
#include <stdio.h>
int main()
{
char tmpbuf[9];
errno_t err;
// Set time zone from TZ environment variable. If TZ is not set,
// the operating system is queried to obtain the default value
// for the variable.
//
_tzset();
// Display operating system-style date and time.
err = _strtime_s( tmpbuf, 9 );
if (err)
{
printf("_strdate_s failed due to an invalid argument.");
exit(1);
}
printf( "OS time:\t\t\t\t%s\n", tmpbuf );
err = _strdate_s( tmpbuf, 9 );
if (err)
{
printf("_strdate_s failed due to an invalid argument.");
exit(1);
}
printf( "OS date:\t\t\t\t%s\n", tmpbuf );
}
OS time: 14:37:49
OS date: 04/25/03