C 标准库 - <time.h>

最新推荐文章于 2023-01-08 21:53:51 发布
最新推荐文章于 2023-01-08 21:53:51 发布
阅读量562 收藏 3
点赞数
分类专栏： c语言

简介

time.h 头文件定义了四个变量类型、两个宏和各种操作日期和时间的函数。

库变量

下面是头文件 time.h 中定义的变量类型：

序号变量 & 描述
1size_t
是无符号整数类型，它是 sizeof 关键字的结果。
2clock_t
这是一个适合存储处理器时间的类型。
3time_t is
这是一个适合存储日历时间类型。
4struct tm
这是一个用来保存时间和日期的结构。

tm 结构的定义如下：

struct tm {
   int tm_sec;         /* 秒，范围从 0 到 59        */
   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    */
   int tm_isdst;       /* 夏令时                */
};

库宏

下面是头文件 time.h 中定义的宏：

序号宏 & 描述
1NULL
这个宏是一个空指针常量的值。
2CLOCKS_PER_SEC
这个宏表示每秒的处理器时钟个数。

库函数

下面是头文件 time.h 中定义的函数：

序号函数 & 描述
1char *asctime(const struct tm *timeptr)
返回一个指向字符串的指针，它代表了结构 timeptr 的日期和时间。
2clock_t clock(void)
返回程序执行起（一般为程序的开头），处理器时钟所使用的时间。
3char *ctime(const time_t *timer)
返回一个表示当地时间的字符串，当地时间是基于参数 timer。
4double difftime(time_t time1, time_t time2)
返回 time1 和 time2 之间相差的秒数 (time1-time2)。
5struct tm *gmtime(const time_t *timer)
timer 的值被分解为 tm 结构，并用协调世界时（UTC）也被称为格林尼治标准时间（GMT）表示。
6struct tm *localtime(const time_t *timer)
timer 的值被分解为 tm 结构，并用本地时区表示。
7time_t mktime(struct tm *timeptr)
把 timeptr 所指向的结构转换为一个依据本地时区的 time_t 值。
8size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)
根据 format 中定义的格式化规则，格式化结构 timeptr 表示的时间，并把它存储在 str 中。
9time_t time(time_t *timer)
计算当前日历时间，并把它编码成 time_t 格式。

1.C 库函数 - asctime()

描述

C 库函数 char *asctime(const struct tm *timeptr) 返回一个指向字符串的指针，它代表了结构 struct timeptr 的日期和时间。

声明

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

char *asctime(const struct tm *timeptr)
参数

timeptr 是指向 tm 结构的指针，包含了分解为如下各部分的日历时间：

struct tm {
   int tm_sec;         /* 秒，范围从 0 到 59                */
   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                    */
   int tm_isdst;       /* 夏令时                        */    
};
返回值

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

实例

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

#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);
}

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

Sat Mar 25 06:10:10 1989

2.C 库函数 - clock()

描述

C 库函数 clock_t clock(void) 返回程序执行起（一般为程序的开头），处理器时钟所使用的时间。为了获取 CPU 所使用的秒数，您需要除以 CLOCKS_PER_SEC。

在 32 位系统中，CLOCKS_PER_SEC 等于 1000000，该函数大约每 72 分钟会返回相同的值。

声明

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

clock_t clock(void)
参数
  • NA
返回值

该函数返回自程序启动起，处理器时钟所使用的时间。如果失败，则返回 -1 值。

实例

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

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

int main()
{
   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);
}

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

程序启动，start_t = 2614
开始一个大循环，start_t = 2614
大循环结束，end_t = 28021
CPU 占用的总时间：0.025407
程序退出...

3.C 库函数 - ctime()

描述

C 库函数 char *ctime(const time_t *timer) 返回一个表示当地时间的字符串，当地时间是基于参数 timer。

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

声明

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

char *ctime(const time_t *timer)
参数
  • timer – 这是指向 time_t 对象的指针，该对象包含了一个日历时间。
返回值

该函数返回一个 C 字符串，该字符串包含了可读格式的日期和时间信息。

实例

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

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

int main ()
{
   time_t curtime;

   time(&curtime);

   printf("当前时间 = %s", ctime(&curtime));

   return(0);
}

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

当前时间 = Mon Aug 13 08:23:14 2012

4.C 库函数 - difftime()

描述

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

声明

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

double difftime(time_t time1, time_t time2)
参数
  • time1 – 这是表示结束时间的 time_t 对象。
  • time2 – 这是表示开始时间的 time_t 对象。
返回值

该函数返回以双精度浮点型 double 值表示的两个时间之间相差的秒数 (time2 - time1)。

实例

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

#include <stdio.h>
#include <time.h>
#ifdef _WIN32
#include <Windows.h>
#else
#include <unistd.h>
#endif

int main ()
{
   time_t start_t, end_t;
   double diff_t;

   printf("程序启动...\n");
   time(&start_t);

   printf("休眠 5 秒...\n");
   sleep(5);

   time(&end_t);
   diff_t = difftime(end_t, start_t);

   printf("执行时间 = %f\n", diff_t);
   printf("程序退出...\n");

   return(0);
}

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

程序启动...
休眠 5 秒...
执行时间 = 5.000000
程序退出...

5.C 库函数 - gmtime()

描述

C 库函数 struct tm *gmtime(const time_t *timer) 使用 timer 的值来填充 tm 结构，并用协调世界时（UTC）也被称为格林尼治标准时间（GMT）表示。

声明

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

struct tm *gmtime(const time_t *timer)
参数
  • timeptr – 这是指向表示日历时间的 time_t 值的指针。
返回值

该函数返回指向 tm 结构的指针，该结构带有被填充的时间信息。下面是 timeptr 结构的细节：

struct tm {
   int tm_sec;         /* 秒，范围从 0 到 59                */
   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                    */
   int tm_isdst;       /* 夏令时                        */    
};
实例

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

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

#define BST (+1)
#define CCT (+8)

int main ()
{

   time_t rawtime;
   struct tm *info;

   time(&rawtime);
   /* 获取 GMT 时间 */
   info = gmtime(&rawtime );

   printf("当前的世界时钟：\n");
   printf("伦敦：%2d:%02d\n", (info->tm_hour+BST)%24, info->tm_min);
   printf("中国：%2d:%02d\n", (info->tm_hour+CCT)%24, info->tm_min);

   return(0);
}

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

当前的世界时钟：
伦敦：14:10
中国：21:10

6.C 库函数 - localtime()

描述

C 库函数 struct tm *localtime(const time_t *timer) 使用 timer 的值来填充 tm 结构。timer 的值被分解为 tm 结构，并用本地时区表示。

声明

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

struct tm *localtime(const time_t *timer)
参数
  • timer – 这是指向表示日历时间的 time_t 值的指针。
返回值

该函数返回指向 tm 结构的指针，该结构带有被填充的时间信息。下面是 tm 结构的细节：

struct tm {
   int tm_sec;         /* 秒，范围从 0 到 59                */
   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                    */
   int tm_isdst;       /* 夏令时                        */    
};
实例

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

#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);
}

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

当前的本地时间和日期：Thu Aug 23 09:12:05 2012

7.C 库函数 - mktime()

描述

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

声明

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

time_t mktime(struct tm *timeptr)
参数
  • timeptr – 这是指向表示日历时间的 time_t 值的指针，该日历时间被分解为以下各部分。下面是 timeptr 结构的细节：
struct tm {
   int tm_sec;         /* 秒，范围从 0 到 59                */
   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                    */
   int tm_isdst;       /* 夏令时                        */    
};
返回值

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

实例

下面的实例演示了 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("错误：不能使用 mktime 转换时间。\n");
   }
   else
   {
      strftime(buffer, sizeof(buffer), "%c", &info );
      print(buffer);
   }

   return(0);
}

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

Wed Jul 4 00:00:01 2001

8.C 库函数 - strftime()

描述

C 库函数 size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr) 根据 format 中定义的格式化规则，格式化结构 timeptr 表示的时间，并把它存储在 str 中。

声明

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

size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)
参数
  • str – 这是指向目标数组的指针，用来复制产生的 C 字符串。
  • maxsize – 这是被复制到 str 的最大字符数。
  • format – 这是 C 字符串，包含了普通字符和特殊格式说明符的任何组合。这些格式说明符由函数替换为表示 tm 中所指定时间的相对应值。格式说明符是：
说明符替换为实例
%a缩写的星期几名称Sun
%A完整的星期几名称Sunday
%b缩写的月份名称Mar
%B完整的月份名称March
%c日期和时间表示法Sun Aug 19 02:56:02 2012
%d一月中的第几天（01-31）19
%H24 小时格式的小时（00-23）14
%I12 小时格式的小时（01-12）05
%j一年中的第几天（001-366）231
%m十进制数表示的月份（01-12）08
%M分（00-59）55
%pAM 或 PM 名称PM
%S秒（00-61）02
%U一年中的第几周，以第一个星期日作为第一周的第一天（00-53）33
%w十进制数表示的星期几，星期日表示为 0（0-6）4
%W一年中的第几周，以第一个星期一作为第一周的第一天（00-53）34
%x日期表示法08/19/12
%X时间表示法02:50:06
%y年份，最后两个数字（00-99）01
%Y年份2012
%Z时区的名称或缩写CDT
%%一个 % 符号%

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

    struct tm {
   int tm_sec;         /* 秒，范围从 0 到 59                */
   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                    */
   int tm_isdst;       /* 夏令时                        */    
};
    返回值

    如果产生的 C 字符串小于 size 个字符（包括空结束字符），则会返回复制到 str 中的字符总数（不包括空结束字符），否则返回零。

    实例

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

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

int main ()
{
   time_t rawtime;
   struct tm *info;
   char buffer[80];

   time( &rawtime );

   info = localtime( &rawtime );

   strftime(buffer,80,"%x - %I:%M%p", info);
   printf("格式化的日期 & 时间 : |%s|\n", buffer );

   return(0);
}

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

    格式化的日期 & 时间 : |08/23/12 - 12:40AM|

    9.C 库函数 - time()

    描述

    C 库函数 time_t time(time_t *seconds) 返回自纪元 Epoch（1970-01-01 00:00:00 UTC）起经过的时间，以秒为单位。如果 seconds 不为空，则返回值也存储在变量 seconds 中。

    声明

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

    time_t time(time_t *t)
    参数
    • seconds – 这是指向类型为 time_t 的对象的指针，用来存储 seconds 的值。
    返回值

    以 time_t 对象返回当前日历时间。

    实例

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

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

int main ()
{
  time_t seconds;

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

  return(0);
}

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

    自 1970-01-01 起的小时数 = 373711
KopWelkin
关注
  • 0
    点赞
  • 踩
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
【STM32】HAL库-RTC实数时钟-使用C库函数time.h-外部时钟LSE-待机模式
05-14
采用STM32F103C8T6单片机，KeilMDK5.32版本 使用LSE作为时钟源 采用time.h库函数，可通过串口助手上位机修改RTC当前计数值 串口与上位机进行通信，串口发送设置为DMA单次模式发送（仿printf） 串口接收设置为DMA循环串口空闲接收，接收到用户数据并修改RTC CNT寄存器后进入待机模式 通过PA0来唤醒单片机 PC13控制LED灯，LED亮灭指示程序正在运行
time.h中的几个常用函数
Charlie_higher的专栏
01-29 5747
time.h头文件中有如下几个常用函数：gmtime()，localtime()，ctime()，asctime()，mktime()，difftime()，time()，_mkgmtime() 详解，以及这些函数注意事项。
time.h头文件函数
peterli_xue的专栏
03-14 4739
time.h头文件中声明的各种函数和数据结构 分类： c语言2010-04-10 17:45 157人阅读 评论(0) 收藏 举报 1.计时函数：clock_t clock( void );         clock_t  在time.h文件中定义为一个长整型：                    #ifndef _CLOCK_T_DEFINED
C程序中对时间的处理——time库函数详解
博雅勇士的博客
08-21 2698
程序中需要包含的头文件:<sys/time.h> <time.h> 一、在C语言中有time_t, tm, timeval等几种类型的时间 1、time_t time_t实际上是长整数类型，定义为：typedef long time_t; /* time value */ 2、timeval timeval是一个结构体，在time.h中定义为： struct timeval...
Linux下获取/设置时间的一些函数
fengruoying93的专栏
07-28 1140
一. time 头文件：#include <time.h> 原型：time_t time(time_t *t) time_t的定义： typedef __darwin_time_ttime_t; typedef long __darwin_time_t; 返回值：UTC(coordinated universal time)时间1970年1月1日00时00分00秒(也称为Linux系统的Epoch时间)到当前时刻的秒数 例1 #include <stdio.h> ...
C语言中的time.h下的函数总结
weixin_46726346的博客
05-08 7644
记录学习的第10天 今天记录一下C语言中的time.h头文件下的各种函数总结 go go go！ 1、计时函数 C语言中的计时函数为clock（），相关的数据类型为clock_t; 很多时候，我们需要做一个计时器； 那么实现出一个计时器，就需要用到这个函数； 具体怎么用呢？ 我们用代码来实现一下； 我用clock函数来计算一个函数所花费的时间； long i=10000000L; clock_...
C语言 time.h 时间函数库
Zach-Zona的博客
10-21 1万+
time.h 头文件定义了四个变量类型、两个宏和各种操作日期和时间的函数。 1 size_t 是无符号整数类型(unsigned int)，它是 sizeof 关键字的结果。 2 clock_t 这是一个适合存储处理器时间的类型。 3 time_t is 这是一个适合存储日历时间类型。 4 struct tm 这是一个用来保存时间和日期的结构 下面是头文件 time.h 中定义的宏： 1
C库函数：time.h
qq_28576837的博客
01-08 2908
C库函数：time.h
c语言标准库详解（十四）：时间函数time.h
热门推荐
SWY's Workshop
05-07 1万+
c语言标准库详解（十四）：时间函数<time.h> 概述 头文件<time.h>中声明了一些处理日期与时间的类型和函数。其中的一些函数用于处理当地时间，因为时区等原因，当地时间与日历时间可能不相同。clock_t和time_t是两个表示时间的算数类型，struct tm用于保存日历时间的各个构成部分。 struct tm 结构tm中各成员的用途及取值范围如下所示： ...
time.h文件中包含的几个函数使用时须注意事项
weixin_30719711的博客
06-16 509
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 t...
C 标准库 – time.h
01-03
C 标准库 – 简介 time.h 头文件定义了四个变量类型、两个宏和各种操作日期和时间的函数。 库变量 下面是头文件 time.h 中定义的变量类型： 序号 变量 & 描述 1 size_t 是无符号整数类型，它是 sizeof 关键字的结果。 2 clock_t 这是一个适合存储处理器时间的类型。 3 time_t is 这是一个适合存储日历时间类型。 4 struct tm 这是一个用来保存时间和日期的结构。 tm 结构的定义如下： struct tm { int tm_sec; /* 秒，范围从 0 到 59        */
STM32使用time.h库函数操作时间日期
10-15
iar,用STM32实现time.h中时间日期库函数，完全的标准时间库，有time.h实现统一强大的日期计算
C语言函数库详解.doc
11-18
C语言函数库，包含 C 标准库、IO 函数、字符处理函数、字符串函数、数学函数、时间和日期函数、其它函数等数百个常用的C语言函数，文档中对常用函数库的函数原型、详细功能、使用示例等进行了详细的介绍说明，。...
C标准库函数集.rar
07-09
本文包括大部分C标准库函数，但没有列出一些用途有限的函数以及某些可以简单的从其他函数合成的函数，也没有包含多...10 日期与时间函数 <time.h> . . . . 48 11 由实现定义的限制 <limits.h> 和 <float.h> . . . 52
linux大纲资料.txt
最新发布
04-23
linux
银行秒杀系统 第十三服创比赛项目.zip
04-23
银行秒杀系统 第十三服创比赛项目
单页登录源码 login登录页源码 html源码.zip
04-23
单页登录源码 login登录页源码 html源码
理性力学 陈至达.pdf
04-23
理性力学 陈至达.pdf
JAVA在线考试管理系统(源代码+论文+开题报告+外文翻译+英文文献+答辩PPT).zip
04-23
JAVA在线考试管理系统(源代码+论文+开题报告+外文翻译+英文文献+答辩PPT)
#include<bits/stdc++.h>#include<time.h>#include<windows.h>#include<stdlib.h>usingnamespacestd
03-18
1. `#include<bits/stdc++.h>`：这是一个常用的头文件引入方式，它包含了C++标准库中的所有头文件。这样可以方便地使用标准库中的各种功能。 2. `#include<time.h>`：这是C语言中的头文件，用于提供时间相关的函数...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值