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　　　　　　　　*/
　　　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;　　　　　　　/*　الإضافي عن Summer Time　　　　　　　　　　　　　　　　*/
};

ماكروس مكتبة

هذه هي الماكروس المحددة في file header time.h:

الترقيم	ماكرو & وصف
1	NULL هذا الماكرو هو value of a null pointer constant.
2	CLOCKS_PER_SEC هذا الماكرو يمثل عدد counts for processor clock في كل ثانية.

وظائف مكتبة

هذه هي الوظائف المحددة في file header time.h:

الترقيم	وظيفة & وصف
1	char *asctime(const struct tm *timeptr) يعيد pointer إلى string يمثل تاريخ Timeptr ووقته.
2	clock_t clock(void) يعيد time المستخدم لـ processor clock من بداية تشغيل البرنامج (عادةً في بداية البرنامج).
3	char *ctime(const time_t *timer) يعيد string يمثل الوقت المحلي بناءً على parameter timer.
4	double difftime(time_t time1, time_t time2) يعيد عدد الثواني الفاصلة بين time1 و time2 (time1-time2).
5	struct tm *gmtime(const time_t *timer) يُفصل قيمة timer إلى structure tm ويُعطى بـ协调世界时(UTC) أو يُدعى أيضًا بـ Greenwhich Mean Time (GMT).
6	struct tm *localtime(const time_t *timer) يُفصل قيمة timer إلى structure tm ويُعطى بـ time zone المحلية.
7	time_t mktime(struct tm *timeptr) يحوّل structure pointers إلى time_t القيمة بناءً على time zone المحلية.
8	size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr) تنسيق الوقت الم Represented by struct timeptr وفقًا للنمط المعرف في format، واحفظها في str.
9	time_t time(time_t *timer) حساب الوقت الحالي على التقويم، و编码ه إلى نموذج time_t.