添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接
学习
实践
活动
专区
工具
TVP
写文章

localtime

在头文件<time.h>中定义

struct tm * localtime(const time_t * time);

(1)

struct tm * localtime_s(const time_t *限制时间,struct tm *限制结果);

(2)

(自C11以来)

1)以struct tm格式将历元以来的给定时间( time_t 指向的值 time )转换为以本地时间表示的日历时间。结果存储在静态存储器中,并返回指向该静态存储器的指针。

2)与(1)相同,只是该函数使用用户提供的存储 result 结果,并且在运行时检测到以下错误并调用当前安装的约束处理函数:

  • time 或者 result 是空指针

与所有边界检查的函数一样, localtime_s 只有 __STDC_LIB_EXT1__ 在实现定义并且用户在包含之前定义 __STDC_WANT_LIB_EXT1__ 为整数常量时 1 才能保证可用 time.h

参数

时间

-

指向要转换的time_t对象的指针

结果

-

指向结构tm对象来存储结果的指针

返回值

1) tm 成功时指向静态内部对象的指针,否则为空指针。该结构可以在 gmtime localtime 和之间共享, ctime 并且可以在每次调用时被覆盖。

2) result 指针的副本或错误上的空指针(可能是运行时约束违规或将指定时间转换为本地日历时间失败)

注释

这个函数 localtime 可能不是线程安全的。