linux 系统函数之 localtime, localtime_r, strftime

1. localtime

头文件：

            #include <time.h>

 函数定义：

            struct tm *localtime(const time_t *timep);

功能：

             把从1970-1-1零点零分到当前时间系统所偏移的秒数时间转换为本地时间，而gmtimes函数转换后的时间没有经过时区变换，是UTC时间 。

参数：

              time_t  从1970-1-1时计算的utc时间。

返回值：

              返回指向tm 结构体的指针.tm结构体是time.h中定义的用于分别存储时间的各个量(年月日等)的结构体.

示例：               

              time_t tNow =time(NULL);

              time_t tEnd = tNow + 1800;

              struct tm* ptm = localtime(&tNow);

              struct tm* ptmEnd = localtime(&tEnd);

 

2. localtime_r

头文件：

#include <time.h>

函数定义：

struct tm *localtime_r(const time_t *timep, struct tm *result);

功能：

把从1970-1-1零点零分到当前时间系统所偏移的秒数时间转换为本地时间，而gmtimes函数转换后的时间没有经过时区变换，是UTC时间 。

参数：

time_t 从1970-1-1时计算的utc时间。 tm 结构体用于获取返回的时间。

返回值：

返回指向tm 结构体的指针.tm结构体是time.h中定义的用于分别存储时间的各个量(年月日等)的结构体.

示例：

              time_t tNow =time(NULL);

             time_t tEnd = tNow + 1800;

             struct tm ptm = { 0 };

             struct tm ptmEnd = { 0 };

             localtime_r(&tNow, &ptm);

             localtime_r(&tEnd, &ptmEnd);

 

 

3. strftime

头文件：

#include <time.h>

函数定义：

size_t strftime(char *s, size_t max, const char *format,
                       const struct tm *tm);

功能：

strftime() 函数根据区域设置格式化本地时间/日期，函数的功能将时间格式化，或者说格式化一个时间字符串。

参数：  

我们可以根据format指向字符串中格式命令把timeptr中保存的时间信息放在strDest指向的字符串中，最多向strDest中存放maxsize个字符。该函数返回向strDest指向的字符串中放置的字符数。

函数strftime()的操作有些类似于sprintf()：识别以百分号(%)开始的格式命令集合，格式化输出结果放在一个字符串中。格式化命令说明串strDest中各种日期和时间信息的确切表示方法。格式串中的其他字符原样放进串中。格式命令列在下面，它们是区分大小写的。

%a 星期几的简写

%A 星期几的全称

%b 月份的简写

%B 月份的全称

%c 标准的日期的时间串

%C 年份的后两位数字

%d 十进制表示的每月的第几天

%D 月/天/年

%e 在两字符域中，十进制表示的每月的第几天

%F 年-月-日

%g 年份的后两位数字，使用基于周的年

%G 年份，使用基于周的年

%h 简写的月份名

%H 24小时制的小时

%I 12小时制的小时

%j 十进制表示的每年的第几天

%m 十进制表示的月份

%M 十时制表示的分钟数

%n 新行符

%p 本地的AM或PM的等价显示

%r 12小时的时间

%R 显示小时和分钟：hh:mm

%S 十进制的秒数

%t 水平制表符

%T 显示时分秒：hh:mm:ss

%u 每周的第几天，星期一为第一天 （值从1到7，星期一为1）

%U 第年的第几周，把星期日作为第一天（值从0到53）

%V 每年的第几周，使用基于周的年

%w 十进制表示的星期几（值从0到6，星期天为0）

%W 每年的第几周，把星期一做为第一天（值从0到53）

%x 标准的日期串

%X 标准的时间串

%y 不带世纪的十进制年份（值从0到99）

%Y 带世纪部分的十制年份

%z，%Z 时区名称，如果不能得到时区名称则返回空字符。

%% 百分号

 

示例：

        struct timeval tv = {0,};
        struct tm      now = {0, };
        char           now_str[32];

        gettimeofday (&tv, NULL)；

         localtime_r (&tv.tv_sec, &now);
        strftime (now_str, 32, "%Y/%m/%d-%H:%M:%S", &now);