侧边栏壁纸
博主头像
noerror

虚灵不寐,众理具而万事出。

  • 累计撰写 238 篇文章
  • 累计创建 9 个标签
  • 累计收到 2 条评论
标签搜索

目 录CONTENT

文章目录

ctime函数用法详解

noerror
2022-10-14 / 0 评论 / 0 点赞 / 34 阅读 / 2,064 字 / 正在检测是否收录...

ctime函数用法详解

ctime函数简介

  • 头文件包含
#include <time.h>
  • 函数定义
char *asctime(const struct tm * tm );
char *asctime_r(const struct tm * tm , char * buf );
char *ctime(const time_t * timep );
char *ctime_r(const time_t * timep , char * buf );
struct tm *gmtime(const time_t * timep );
struct tm *gmtime_r(const time_t * timep , struct tm * result );
struct tm *localtime(const time_t * timep );
struct tm *localtime_r(const time_t * timep , struct tm * result );
time_t mktime(struct tm * tm );

ctime函数常见使用错误

  • 编译错误
    warning: implicit declaration of function ‘ctime’ [-Wimplicit-function-declaration]
    解决办法:包含头文件
#include <time.h>

ctime函数详细描述

ctime ()、gmtime ()和localtime ()函数都采用数据类型time_t的参数,该参数表示日历时间。当被解释为绝对时间值时,它表示自1970-01-01 00:00:00+0000(UTC)以来经过的秒数。
asctime ()和mktime ()函数都接受一个表示分解时间的参数,分解时间是一个分为年、月、日等的表示形式。
分解时间存储在结构tm中,该结构在中定义如下:

struct tm {
   int tm_sec;    /* Seconds (0\-60) */
   int tm_min;    /* Minutes (0\-59) */
   int tm_hour;   /* Hours (0\-23) */
   int tm_mday;   /* Day of the month (1\-31) */
   int tm_mon;    /* Month (0\-11) */
   int tm_year;   /* Year \- 1900 */
   int tm_wday;   /* Day of the week (0\-6, Sunday = 0) */
   int tm_yday;   /* Day in the year (0\-365, 1 Jan = 0) */
   int tm_isdst;  /* Daylight saving time */
};

tm结构的成员是:

  • tm_sec分钟后的秒数,通常在0到59的范围内,但可以最多60秒,以允许闰秒。
  • tm_min小时后的分钟数,范围为0到59。
  • tm_hour午夜后的小时数,范围为0到23。
  • tm_mday一个月中的某一天,在1到31的范围内。
  • tm_mon自1月份以来的月份数,在0到11之间。
  • 1900年以来的年数。
  • tm_wday自周日以来的天数,范围为0到6。
  • tm_yday自1月1日以来的天数,范围在0到365之间。
  • tm_isdst指示夏时制是否在描述的时间生效的标志。如果夏令时生效,则该值为正值;如果不生效,则为零;如果信息不可用,则为负值。

call.bi ctime(t)等效于.bi asctime(localtime(t))\fr。它将日历时间t转换为表单的以空结尾的字符串

"Wed Jun 30 21:49:08 1993\en"

一周中几天的缩写是“sun”、“mon”、“tue”、“wed”、“thu”、“frii”和“sat”。月份之简称为“一月”、“二月”、“三月”、“四月”、“五月”、“六月”、“七月”、“八月”、“九月”、“十月”、“十一月”及“十二月”。返回值指向一个静态分配的字符串,该字符串可能会被对任何日期和时间函数的后续调用所覆盖。该函数还设置外部变量tzname、timezone和daylight(有关当前时区的信息请参见tzset (3))。可重入版本ctime_r ()执行相同操作,但将字符串存储在用户提供的缓冲区中,该缓冲区至少应有26个字节的空间。它不需要设置tzname、ppp3和ppp4。
gmtime ()函数将日历时间timep转换为分解的时间表示,以协调世界时(UTC)表示。当年份不适合整数时,它可能返回NULL。返回值指向一个静态分配的结构,该结构可能会被对任何日期和时间函数的后续调用所覆盖。gmtime_r ()函数执行相同的操作,但将数据存储在用户提供的结构中。
localtime ()函数将日历时间timep转换为相对于用户指定时区表示的分解时间表示形式。该函数的作用就像调用了tzset (3)一样,并将外部变量tzname设置为当前时区的信息,timezone设置为协调世界时(UTC)和本地标准时间之间的差(以秒为单位),如果夏令时规则在一年中的某个部分应用,则daylight设置为非零值。返回值指向一个静态分配的结构,该结构可能会被对任何日期和时间函数的后续调用所覆盖。localtime_r ()函数执行相同的操作,但将数据存储在用户提供的结构中。它不需要设置tzname、timezone和daylight。
asctime ()函数将分解后的时间值tm转换为以null结尾的字符串,其格式与ctime ()相同。返回值指向静态分配的字符串,该字符串可能会被随后对任何日期和时间函数的调用所覆盖。asctime_r ()函数执行相同的操作,但将字符串存储在用户提供的缓冲区中,该缓冲区至少应有26字节的空间。
mktime ()函数将分解的时间结构(表示为本地时间)转换为日历时间表示。函数忽略调用方在tm_wday和tm_yday字段中提供的值。tm_isdst字段中指定的值通知mktime ()夏时制是否对tm结构中提供的时间有效:正值表示夏时制有效;零表示DST不生效;负值表示mktime ()应该(使用时区信息和系统数据库)尝试确定DST是否在指定时间生效。
mktime ()函数修改tm结构的字段如下:tm_wday和tm_yday被设置为从其他字段的内容中确定的值;如果结构成员在其有效间隔之外,将对其进行归一化(例如,10月40号改为11月9日);tm_isdst被分别设置为(不管其初始值如何)正值或0,以指示DST在指定时间是否有效。调用mktime ()还将外部变量tzname设置为有关当前时区的信息。
如果指定的分解时间不能表示为日历时间(从纪元开始的秒),mktime ()返回(time_t)\ -1,并且不改变分解时间结构的成员。

ctime函数返回值

成功后,gmtime ()和localtime ()返回一个指向"struct\ tm" 的指针
成功后,gmtime_r ()和localtime_r ()返回result 指向的结构的地址
成功后,asctime ()和ctime ()返回一个指向字符串的指针。
成功后,asctime_r ()和ctime_r ()返回一个指针,指向buf 所指向的字符串
成功后,mktime ()返回日历时间(从纪元开始的秒数),表示为time_t 类型的值
错误时,mktime ()返回值"(time_t)\ -1" ,其余函数错误时返回NULL。在错误时,errno被设置为指示错误的原因。

ctime函数错误码

  • EOVERFLOW 无法表示结果。

ctime函数其他说明

四个函数asctime ()、ctime ()、gmtime ()和localtime ()返回静态数据的指针,因此不是线程安全的。线程安全版本,asctime_r (),ctime_r (),gmtime_r ()和localtime_r ()是由susv2指定的。
POSIX.1-2001指出:“asctime ()、ctime ()、gmtime ()和localtime ()函数将返回两个静态对象之一的值:分解的时间结构和char 类型的数组。任何函数的执行都可能覆盖任何其他函数在这些对象中返回的信息。”这可能发生在glibc实现中。
在包括glibc在内的许多实现中,tm_mday中的0被解释为前一个月的最后一天。
struct tm的glibc版本有其他字段

const char *tm_zone;      /* Timezone abbreviation */

在包含 之前设置 _BSD_SOURCE 时定义的,这是一个BSD扩展,出现在4.3BSD-Reno中。
根据POSIX.1-2001,要求localtime ()的行为就像调用了tzset (3)一样,而localtime_r ()没有这个要求。对于可移植代码,应该在localtime_r ()之前调用tzset (3)

0

评论区