C/C++ 日期 & 时间函数总结

本是古典何须时尚 2023-09-26 19:38 10阅读 0赞

## 使用C标准库 ##

有四个与时间相关的类型：**clock\_t、time\_t、size\_t** 和 **tm**。类型 clock\_t、size\_t 和 time\_t 能够把系统时间和日期表示为某种整数

### 头文件 ###

#include <time.h>
    #include <stdio.h>

tm 结构:

struct tm {
      int tm_sec;   // 秒，正常范围从 0 到 59，但允许至 61
      int tm_min;   // 分，范围从 0 到 59
      int tm_hour;  // 小时，范围从 0 到 23
      int tm_mday;  // 一月中的第几天，范围从 1 到 31
      int tm_mon;   // 月，范围从 0 到 11
      int tm_year;  // 自 1900 年起的年数
      int tm_wday;  // 一周中的第几天，范围从 0 到 6，从星期日算起
      int tm_yday;  // 一年中的第几天，范围从 0 到 365，从 1 月 1 日算起
      int tm_isdst; // 夏令时
    };

包含以下函数

## clock ##

clock_t clock (void);

返回程序消耗的处理器时间。返回的值以时钟滴答表示，它是一个固定的时间单位，但系统特定的长度(与每秒CLOCKS\_PER\_SEC时钟滴答的关系)。时钟所使用的参考时间在不同的系统中是不同的，但是它与程序的执行(通常是它的启动)有关。为了计算程序的实际处理时间，clock返回的值应与之前调用同一函数返回的值进行比较。

失败时，函数返回-1值。

#### 示例 ####

clock_t start_t, end_t;
        double total_t;
        int i;
    
        start_t = clock();
        printf("程序启动，start_t = %ld\n", start_t);
    
        printf("开始一个大循环，start_t = %ld\n", start_t);
        for (i = 0; i < 10000000; i++)
        {
        }
        end_t = clock();
        printf("大循环结束，end_t = %ld\n", end_t);
    
        total_t = (double)(end_t - start_t) / CLOCKS_PER_SEC;
        printf("CPU 占用的总时间：%f\n", total_t);
        printf("程序退出...\n");
        return 0;

## difftime ##

double difftime (time_t time1 , time_t time2 );

返回 **time1** 和 **time2** 之间相差的秒数 **(time1 - time2)**。这两个时间是在日历时间中指定的，表示了自纪元 Epoch（协调世界时 UTC：1970-01-01 00:00:00）起经过的时间。

#### 示例 ####

time_t now;
        struct tm newyear;
        double seconds;
    
        time(&now);  /* get current time; same as: now = time(NULL)  */
    
        newyear = *localtime(&now);
    
        newyear.tm_hour = 0; newyear.tm_min = 1; newyear.tm_sec = 0;
        newyear.tm_mon = 0;  newyear.tm_mday = 0;
    
        seconds = difftime(now, mktime(&newyear));
    
        printf("%.f 当前时区距新年的秒数 \n", seconds);

注意，此处可能会出现以下错误

C4996 'localtime': This function or variable may be unsafe. Consider using localtime\_s instead. To disable deprecation, use \_CRT\_SECURE\_NO\_WARNINGS. See online help for details.   
解决方案：

\#pragma warning( disable : 4996 )

![a4ec5676f8ca42ad8a0fec6ebf0cf94f.png][]

### mktime ###

把 **timeptr** 所指向的结构转换为自 1970 年 1 月 1 日以来持续时间的秒数，发生错误时返回-1。

#### 案例 ####

/* 输入日期判断是周几 */
    #include <stdio.h>      /* printf, scanf */
    #include <time.h>       /* time_t, struct tm, time, mktime */
     
    int main ()
    {
        time_t rawtime;
        struct tm * timeinfo;
        int year, month ,day;
        const char * weekday[] = { "周日", "周一","周二", "周三","周四", "周五", "周六"};
     
        /* 用户输入日期 */
        printf ("年: "); fflush(stdout); scanf ("%d",&year);
        printf ("月: "); fflush(stdout); scanf ("%d",&month);
        printf ("日: "); fflush(stdout); scanf ("%d",&day);
     
        /* 获取当前时间信息，并修改用户输入的输入信息 */
        time ( &rawtime );
        timeinfo = localtime ( &rawtime );
        timeinfo->tm_year = year - 1900;
        timeinfo->tm_mon = month - 1;
        timeinfo->tm_mday = day;
     
        /* 调用 mktime: timeinfo->tm_wday  */
        mktime ( timeinfo );
     
        printf ("那一天是：%s\n", weekday[timeinfo->tm_wday]);
     
        return 0;
    }

## time ##

time_t time (time_t* timer);

该函数返回系统的当前日历时间，自 1970 年 1 月 1 日以来经过的秒数。如果系统没有时间，则返回 -1。

#### 示例 ####

time_t seconds;
     
      seconds = time(NULL);
      printf("自 1970-01-01 起的小时数 = %ld\n", seconds/3600);

time_t timer;
      struct tm y2k = {0};
      double seconds;
    
      y2k.tm_hour = 0;   y2k.tm_min = 0; y2k.tm_sec = 0;
      y2k.tm_year = 100; y2k.tm_mon = 0; y2k.tm_mday = 1;
    
      time(&timer);  /* get current time; same as: timer = time(NULL)  */
    
      seconds = difftime(timer,mktime(&y2k));
    
      printf ("%.f 从2000年1月1日到当前时区的秒数", seconds);

## asctime ##

char* asctime (const struct tm * timeptr);

该函数返回一个 C 字符串，包含了可读格式的日期和时间信息 **Www Mmm dd hh:mm:ss yyyy**，其中，*Www* 表示星期几，*Mmm* 是以字母表示的月份，*dd* 表示一月中的第几天，*hh:mm:ss* 表示时间，*yyyy* 表示年份。

#### 示例 ####

#include <stdio.h>
    #include <string.h>
    #include <time.h>
    
    int main()
    {
       struct tm t;
    
       t.tm_sec    = 10;
       t.tm_min    = 10;
       t.tm_hour   = 6;
       t.tm_mday   = 25;
       t.tm_mon    = 2;
       t.tm_year   = 89;
       t.tm_wday   = 6;
    
       puts(asctime(&t));
       
       return(0);
    }

#include <stdio.h>      /* printf */
    #include <time.h>       /* time_t, struct tm, time, localtime, asctime */
    
    int main ()
    {
      time_t rawtime;
      struct tm * timeinfo;
    
      time ( &rawtime );
      timeinfo = localtime ( &rawtime );
      printf ( "The current date/time is: %s", asctime (timeinfo) );
    
      return 0;
    }

## ctime ##

char* ctime (const time_t * timer);

返回一个表示当地时间的字符串，当地时间是基于参数 **timer**。

返回的字符串格式如下： **Www Mmm dd hh:mm:ss yyyy** 其中，*Www* 表示星期几，*Mmm* 是以字母表示的月份，*dd* 表示一月中的第几天，*hh:mm:ss* 表示时间，*yyyy* 表示年份。

#### 示例 ####

#include <stdio.h>
    #include <time.h>
     
    int main ()
    {
       time_t curtime;
     
       time(&curtime);
     
       printf("当前时间 = %s", ctime(&curtime));
     
       return(0);
    }

### gmtime ###

struct tm * gmtime (const time_t * timer);

使用timer指向的值来用表示对应时间的值填充tm结构，表示为UTC时间(即GMT时区的时间)。

#### 示例 ####

#include <stdio.h>      /* puts, printf */
    #include <time.h>       /* time_t, struct tm, time, gmtime */
    
    #define MST (-7)
    #define UTC (0)
    #define CCT (+8)
    
    int main ()
    {
      time_t rawtime;
      struct tm * ptm;
    
      time ( &rawtime );
    
      ptm = gmtime ( &rawtime );
    
      puts ("Current time around the World:");
      printf ("Phoenix, AZ (U.S.) :  %2d:%02d\n", (ptm->tm_hour+MST)%24, ptm->tm_min);
      printf ("Reykjavik (Iceland) : %2d:%02d\n", (ptm->tm_hour+UTC)%24, ptm->tm_min);
      printf ("Beijing (China) :     %2d:%02d\n", (ptm->tm_hour+CCT)%24, ptm->tm_min);
    
      return 0;
    }

### localtime ###

struct tm * localtime (const time_t * timer);

本地时区时间

#### 示例 ####

#include <stdio.h>
    #include <time.h>
     
    int main ()
    {
       time_t rawtime;
       struct tm *info;
       char buffer[80];
     
       time( &rawtime );
     
       info = localtime( &rawtime );
       printf("当前的本地时间和日期：%s", asctime(info));
     
       return(0);
    }

time_t rawtime;
      struct tm * timeinfo;
    
      time (&rawtime);
      timeinfo = localtime (&rawtime);
      printf ("Current local time and date: %s", asctime(timeinfo));

## strftime ##

size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)

该函数可用于格式化日期和时间为指定的格式。

*  **str** \-- 这是指向目标数组的指针，用来复制产生的 C 字符串。
 *  **maxsize** \-- 这是被复制到 str 的最大字符数。
 *  **format** \-- 这是 C 字符串，包含了普通字符和特殊格式说明符的任何组合。这些格式说明符由函数替换为表示 tm 中所指定时间的相对应值。格式说明符是：

<table> 
 <tbody> 
  <tr> 
   <td>%a</td> 
   <td>缩写的星期几名称</td> 
   <td>Sun</td> 
  </tr> 
  <tr> 
   <td>%A</td> 
   <td>完整的星期几名称</td> 
   <td>Sunday</td> 
  </tr> 
  <tr> 
   <td>%b</td> 
   <td>缩写的月份名称</td> 
   <td>Mar</td> 
  </tr> 
  <tr> 
   <td>%B</td> 
   <td>完整的月份名称</td> 
   <td>March</td> 
  </tr> 
  <tr> 
   <td>%c</td> 
   <td>日期和时间表示法</td> 
   <td>Sun Aug 19 02:56:02 2012</td> 
  </tr> 
  <tr> 
   <td>%d</td> 
   <td>一月中的第几天（01-31）</td> 
   <td>19</td> 
  </tr> 
  <tr> 
   <td>%H</td> 
   <td>24 小时格式的小时（00-23）</td> 
   <td>14</td> 
  </tr> 
  <tr> 
   <td>%I</td> 
   <td>12 小时格式的小时（01-12）</td> 
   <td>05</td> 
  </tr> 
  <tr> 
   <td>%j</td> 
   <td>一年中的第几天（001-366）</td> 
   <td>231</td> 
  </tr> 
  <tr> 
   <td>%m</td> 
   <td>十进制数表示的月份（01-12）</td> 
   <td>08</td> 
  </tr> 
  <tr> 
   <td>%M</td> 
   <td>分（00-59）</td> 
   <td>55</td> 
  </tr> 
  <tr> 
   <td>%p</td> 
   <td>AM 或 PM 名称</td> 
   <td>PM</td> 
  </tr> 
  <tr> 
   <td>%S</td> 
   <td>秒（00-61）</td> 
   <td>02</td> 
  </tr> 
  <tr> 
   <td>%U</td> 
   <td>一年中的第几周，以第一个星期日作为第一周的第一天（00-53）</td> 
   <td>33</td> 
  </tr> 
  <tr> 
   <td>%w</td> 
   <td>十进制数表示的星期几，星期日表示为 0（0-6）</td> 
   <td>4</td> 
  </tr> 
  <tr> 
   <td>%W</td> 
   <td>一年中的第几周，以第一个星期一作为第一周的第一天（00-53）</td> 
   <td>34</td> 
  </tr> 
  <tr> 
   <td>%x</td> 
   <td>日期表示法</td> 
   <td>08/19/12</td> 
  </tr> 
  <tr> 
   <td>%X</td> 
   <td>时间表示法</td> 
   <td>02:50:06</td> 
  </tr> 
  <tr> 
   <td>%y</td> 
   <td>年份，最后两个数字（00-99）</td> 
   <td>01</td> 
  </tr> 
  <tr> 
   <td>%Y</td> 
   <td>年份</td> 
   <td>2012</td> 
  </tr> 
  <tr> 
   <td>%Z</td> 
   <td>时区的名称或缩写</td> 
   <td>CDT</td> 
  </tr> 
  <tr> 
   <td>%%</td> 
   <td>一个 % 符号</td> 
   <td>%</td> 
  </tr> 
 </tbody> 
</table>

*  **timeptr** \-- 这是指向 tm 结构的指针，该结构包含了一个被分解为以下各部分的日历时间：

#### 示例 ####

int main ()
    {
      time_t rawtime;
      struct tm * timeinfo;
      char buffer [80];
    
      time (&rawtime);
      timeinfo = localtime (&rawtime);
    
      strftime (buffer,80,"Now it's %I:%M%p.",timeinfo);
      puts (buffer);
    
      return 0;
    }

####  ####

[a4ec5676f8ca42ad8a0fec6ebf0cf94f.png]: https://img-blog.csdnimg.cn/a4ec5676f8ca42ad8a0fec6ebf0cf94f.png