C 库函数 - mktime()

描述

C 库函数 time_t mktime(struct tm *timeptr) 把 timeptr 所指向的结构转换为一个依据本地时区的 time_t 值。

声明

下面是 mktime() 函数的声明。

  1. time_t mktime(struct tm *timeptr)

参数

  • timeptr — 这是指向表示日历时间的 time_t 值的指针，该日历时间被分解为以下各部分。下面是 timeptr 结构的细节：
  1. struct tm {
  2.    int tm_sec;         /* 秒，范围从 0 到 59                */
  3.    int tm_min;         /* 分，范围从 0 到 59                */
  4.    int tm_hour;        /* 小时，范围从 0 到 23                */
  5.    int tm_mday;        /* 一月中的第几天，范围从 1 到 31                    */
  6.    int tm_mon;         /* 月份，范围从 0 到 11                */
  7.    int tm_year;        /* 自 1900 起的年数                */
  8.    int tm_wday;        /* 一周中的第几天，范围从 0 到 6                */
  9.    int tm_yday;        /* 一年中的第几天，范围从 0 到 365                    */
  10.    int tm_isdst;       /* 夏令时                        */    
  11. };

返回值

该函数返回一个 time_t 值，该值对应于以参数传递的日历时间。如果发生错误，则返回 -1 值。

实例

下面的实例演示了 mktime() 函数的用法。

实例

  1. /* 输入日期判断是周几 */
  2. #include <stdio.h>      /* printf, scanf */
  3. #include <time.h>       /* time_t, struct tm, time, mktime */
  5. int main ()
  6. {
  7.     time_t rawtime;
  8.     struct tm * timeinfo;
  9.     int year, month ,day;
  10.     const char * weekday[] = { "周日", "周一","周二", "周三","周四", "周五", "周六"};
  12.     /* 用户输入日期 */
  13.     printf ("年: "); fflush(stdout); scanf ("%d",&year);
  14.     printf ("月: "); fflush(stdout); scanf ("%d",&month);
  15.     printf ("日: "); fflush(stdout); scanf ("%d",&day);
  17.     /* 获取当前时间信息，并修改用户输入的输入信息 */
  18.     time ( &rawtime );
  19.     timeinfo = localtime ( &rawtime );
  20.     timeinfo->tm_year = year - 1900;
  21.     timeinfo->tm_mon = month - 1;
  22.     timeinfo->tm_mday = day;
  24.     /* 调用 mktime: timeinfo->tm_wday  */
  25.     mktime ( timeinfo );
  27.     printf ("那一天是：%s\n", weekday[timeinfo->tm_wday]);
  29.     return 0;
  30. }

让我们编译并运行上面的程序，这将产生以下结果：

  1. 年: 2018
  2. 月: 7
  3. 日: 26
  4. 那一天是：周四