C 库 - mktime() 函数

---

---

C 库的 mktime() 函数用于更改时间。它将时间结构转换为日历时间值。此函数接受日期和时间的各个组成部分，例如年、月、日、小时、分钟和秒，并计算相应的 timestamps。

这里，`time_t mktime(struct tm *timeptr)` 根据本地时区将 `timeptr` 指向的结构转换为 `time_t` 值。

语法

以下是 C 库 mktime() 函数的语法：

time_t mktime(struct tm *timeptr)

参数

此函数只接受一个参数：

• timeptr − 这是指向 `time_t` 值的指针，该值表示分解为其组成部分的日历时间。
• 以下是 `timeptr` 结构的详细信息：

struct tm {
   int tm_sec;         /* seconds,  range 0 to 59          */
   int tm_min;         /* minutes, range 0 to 59           */
   int tm_hour;        /* hours, range 0 to 23             */
   int tm_mday;        /* day of the month, range 1 to 31  */
   int tm_mon;         /* month, range 0 to 11             */
   int tm_year;        /* The number of years since 1900   */
   int tm_wday;        /* day of the week, range 0 to 6    */
   int tm_yday;        /* day in the year, range 0 to 365  */
   int tm_isdst;       /* daylight saving time             */	
};

返回值

此函数返回一个与作为参数传递的日历时间相对应的 `time_t` 值。如果发生错误，则返回 -1。

示例 1

以下是 C 库程序的基本示例，用于演示 mktime() 函数。

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

int main () {
   int ret;
   struct tm info;
   char buffer[80];

   info.tm_year = 2001 - 1900;
   info.tm_mon = 7 - 1;
   info.tm_mday = 4;
   info.tm_hour = 0;
   info.tm_min = 0;
   info.tm_sec = 1;
   info.tm_isdst = -1;

   ret = mktime(&info);
   if( ret == -1 ) {
      printf("Error: unable to make time using mktime\n");
   } else {
      strftime(buffer, sizeof(buffer), "%c", &info );
      printf(buffer);
   }
 
   return(0);
} 

输出

执行上述代码后，我们将得到以下结果：

Wed Jul 4 00:00:01 2001

示例 2

在此程序中，我们计算从现在开始的日期和时间（100 天和 30 小时），并打印相应的星期几。

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

char *weekday[] = { "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" };

int main(void) {
   time_t dt1, dt3;
   struct tm *t2;

   dt1 = time(NULL);
   t2 = localtime(&dt1);

   // Add 100 days and 30 hours
   t2->tm_mday += 100;
   t2->tm_hour += 30;

   dt3 = mktime(t2);

   printf("It will be a %s after 100 days and 30 hours from now.\n", weekday[t2->tm_wday]);
   return 0;
}

输出

上述代码将产生以下结果：

It will be a Saturday after 100 days and 30 hours from now.