C Standard Library 简明教程

C Library - <time.h>

time.h 头文件定义四种变量类型、两个宏和各种函数，用于处理日期和时间。

The time.h header defines four variable types, two macro and various functions for manipulating date and time.

头文件 time.h 中定义的变量类型如下 −

Following are the variable types defined in the header time.h −

Sr.No.	Variable & Description
1	size_t This is the unsigned integral type and is the result of the sizeof keyword.
2	clock_t This is a type suitable for storing the processor time.
3	time_t is This is a type suitable for storing the calendar time.
4	struct tm This is a structure used to hold the time and date.

以下为在头文件 time.h 中定义的宏 −

Following are the macros defined in the header time.h −

Sr.No.

Macro & Description

NULL This macro is the value of a null pointer constant.

CLOCKS_PER_SEC This macro represents the number of processor clocks per second.

以下是头文件 time.h 中定义的函数 −

Following are the functions defined in the header time.h −

Sr.No.	Function & Description
1	char asctime(const struct tm timeptr)Returns a pointer to a string which represents the day and time of the structure timeptr.
2	clock_t clock(void)Returns the processor clock time used since the beginning of an implementation defined era (normally the beginning of the program).
3	char ctime(const time_t timer)Returns a string representing the localtime based on the argument timer.
4	double difftime(time_t time1, time_t time2)Returns the difference of seconds between time1 and time2 (time1-time2).
5	struct tm gmtime(const time_t timer)The value of timer is broken up into the structure tm and expressed in Coordinated Universal Time (UTC) also known as Greenwich Mean Time (GMT).
6	struct tm localtime(const time_t timer)The value of timer is broken up into the structure tm and expressed in the local time zone.
7	time_t mktime(struct tm *timeptr)Converts the structure pointed to by timeptr into a time_t value according to the local time zone.
8	size_t strftime(char str, size_t maxsize, const char format, const struct tm *timeptr)Formats the time represented in the structure timeptr according to the formatting rules defined in format and stored into str.
9	time_t time(time_t *timer)Calculates the current calender time and encodes it into time_t format.
10	size_t wcsftime( wchar_t* str, size_t count, const wchar_t* format, const struct tm* time )Converts a tm object to custom wide string textual representation.