3.Linux应用编程之时间类编程函数手册

john-rgt

第1类 时间编程类
1.1 获取日历时间
1.1.1 函数名
time
1.1.2 函数原形
time_t time(time_t *t)
1.1.3 函数功能
返回日历时间（）从1970 1月1日00：00到现在的时间
1.1.4 所属头文件
<time.h>
1.1.5 返回值
成功：返回日历时间  失败：-1
1.1.6 参数说明
t:一般为NULL


1.2 获取格林威治时间
1.2.1 函数名
gmtime
1.2.2 函数原形
struct tm *gmtime(const time_t *timep)
1.2.3 函数功能
将参数timep所知道的日历时间转化为世界标准时间
1.2.4 所属头文件
<time.h>
1.2.5 返回值
成功：世界标准时间  ，struct tm存储 失败：
1.2.6 参数说明
Timep：待转化的日历时间

1.3 获取本地时间
1.3.1 函数名
localtime
1.3.2 函数原形
struct tm *gmtime(const time_t *timep)
1.3.3 函数功能
返回本地时间
1.3.4 所属头文件
<time.h>
1.3.5 返回值
返回本地时间，以struct tm格式存储的本地时间
失败返回空指针
1.3.6 参数说明
Timep：待转化的日历时间

1.4 以字符串方式显示时间
1.4.1 函数名
asctime
1.4.2 函数原形
char *asctime(const struct tm *tm)
1.4.3 函数功能
将tm格式的时间转化为字符串
1.4.4 所属头文件
<time.h>
1.4.5 返回值
字符串方式显示的时间
1.4.6 参数说明
待转化的tm格式的时间


1.5 获取高精度时间
1.5.1 函数名
gettimrofday
1.5.2 函数原形
Int gettimrofday(struct timeval *tv,struct timezone *tz)
1.5.3 函数功能
获取高精度的本地时间
1.5.4 所属头文件
<sys/time.h>
1.5.5 返回值
成功：0  失败-1
1.5.6 参数说明
struct timeval *tv 保存从1970年1月1日00：00:00到现在的秒和微秒
struct timezone *tz  通常为空