C Standard Library Time H

Introduction

time.h header file defines four variable types, two macros, and various functions for manipulating dates and times.

<time.h> is a header file in the C standard library that provides functions and types for handling and manipulating dates and times. The functions in this header are used to get the current time, set time, format time, calculate time differences, and more.

\n\n

Constants & Macros

\n\n \n \n \n \n

Constant/Macro	Description
`CLOCKS_PER_SEC`	Number of clock ticks per second.
`NULL`	Null pointer constant.
`TIME_UTC`	Represents UTC time (C11).

\n\n

Library Variables

The following are the variable types defined in the time.h header:

\n\n \n \n \n \n \n

No.	Variable & Description
1	size_t is an unsigned integer type, which is the result of the sizeof operator.
2	clock_t is a type suitable for storing processor time.
3	time_t is a type suitable for storing calendar time.
4	struct tm is a structure used to store time and date.

The tm structure is defined as follows:

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

\n\n

Library Macros

The following are the macros defined in the time.h header:

\n\n \n \n \n

No.	Macro & Description
1	NULL This macro holds the value of a null pointer constant.
2	CLOCKS_PER_SEC This macro represents the number of processor clock ticks per second.

\n\n

Library Functions

The following are the functions defined in the time.h header:

\n\n \n \n \n \n \n \n \n \n \n \n \n

No.	Function & Description
1	char asctime(const struct tm timeptr) Returns a pointer to a string representing the date and time stored in the timeptr structure.
2	clock_t clock(void) Returns the amount of processor time used by the program since its execution (generally from the start).
3	char ctime(const time_t timer) Returns a string representing local time, based on the timer argument.
4	double difftime(time_t time1, time_t time2) Returns the difference in seconds between time1 and time2 (time1-time2).
5	struct tm gmtime(const time_t timer) Breaks down the timer value into a tm structure and represents it in Coordinated Universal Time (UTC), also known as Greenwich Mean Time (GMT).
6	struct tm localtime(const time_t timer) Breaks down the timer value into a tm structure and represents it in the local timezone.
7	time_t mktime(struct tm *timeptr) Converts the structure pointed to by timeptr into a time_t value according to the local timezone.
8	size_t strftime(char str, size_t maxsize, const char format, const struct tm *timeptr) Formats the time represented by the timeptr structure according to the rules defined in format, and stores it in str.
9	time_t time(time_t *timer) Calculates the current calendar time and encodes it as a time_t object.
10	int timespec_get(struct timespec *ts, int base); Gets the current time (C11).

\n\n

Examples

The following are examples using some functions from <time.h>.

\n\n

Get Current Time:

Example

#include \n\n#include \n\nint main(){\n\n time_t current_time;\n\ntime(&current_time);\n\nprintf("Current time: %s",ctime(&current_time));\n\nreturn 0;\n\n}

\n\n

Format Time:

Example

#include \n\n#include \n\nint main(){\n\n time_t current_time;\n\nstruct tm *time_info;\n\nchar buffer;\n\ntime(&current_time);\n\n time_info =localtime(&current_time);\n\nstrftime(buffer,sizeof(buffer),"%Y-%m-%d %H:%M:%S", time_info);\n\nprintf("Formatted time: %sn", buffer);\n\nreturn 0;\n\n}

\n\n

Calculate Time Difference:

Example

#include \n\n#include \n\nint main(){\n\n time_t start_time, end_time;\n\ndouble time_diff;\n\ntime(&start_time);\n\n// Simulate a time-consuming operation\n\nfor(int i =0; i <100000000; i++);\n\ntime(&end_time);\n\n time_diff =difftime(end_time, start_time);\n\nprintf("Time difference: %.2f secondsn", time_diff);\n\nreturn 0;\n\n}

\n\n

Using struct tm:

Example

#include \n\n#include \n\nint main(){\n\nstruct tm time_info;\n\nchar buffer;\n\ntime_info.tm_year=2024-1900;// Year calculated starting from 1900\n\n time_info.tm_mon=5;// June, ranging from 0 to 11\n\n time_info.tm_mday=12;\n\n time_info.tm_hour=12;\n\n time_info.tm_min=0;\n\n time_info.tm_sec=0;\n\n time_info.tm_isdst=-1;// Automatically determine whether daylight saving time is in effect\n\nmktime(&time_info);\n\nstrftime(buffer,sizeof(buffer),"%Y-%m-%d %H:%M:%S",&time_info);\n\nprintf("Custom time: %sn", buffer);\n\nreturn 0;\n\n}

\n\n

Notes

When using localtime and gmtime, the returned pointer points to a statically allocated struct tm. Each call will overwrite the previous contents.
When using the mktime function, ensure that all fields within the struct tm are valid.
When using the strftime function for time formatting, ensure the destination buffer is large enough to avoid buffer overflow.

By understanding and using the functions provided by <time.h>, you can conveniently manipulate dates and times, thereby writing more feature-rich and efficient C programs.

YouTip