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);

©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页