time.h

Overview

Related Modules:

TIME

Description:

Provides time-related structures and functions.

You can perform time-related management operations, including obtaining and setting broken-down time and system ticks, and manipulating timers.

Since:

1.0

Version:

1.0

Summary

Data Structures

Data Structure Name

Description

tm

Describes date and time information.

itimerspec

Sets a timer.

Macros

Macro Name and Value

Description

CLOCK_REALTIME   0

Defines the clock that runs in real time.

Functions

Function Name

Description

time (time_t t)

time_t 

Obtains the time.

difftime (time_t time1, time_t time2)

double 

Calculates the difference between two times, in seconds.

mktime (struct tm tm)

time_t 

Converts the broken-down time in the tm structure into seconds.

strftime (char restrict s, size_t n, const char restrict f, const struct tm restrict tm)

size_t 

Converts the broken-down time in the tm structure to a string in the required format.

gmtime (const time_t t)

struct tm  

Converts the number of seconds to the UTC time in the tm structure.

localtime (const time_t t)

struct tm  

Converts the number of seconds to the local time in the tm structure.

asctime (const struct tm tm)

char  

Converts the broken-down time in the tm structure into a string.

ctime (const time_t timep)

char  

Converts the date and time into a string.

strftime_l (char restrict s, size_t n, const char *restrict f, const struct tm __restrict tm, locale_t loc)

size_t 

Converts the broken-down time in the tm structure to a string in a specified programming language and format.

gmtime_r (const time_t restrict t, struct tm *restrict tm)

struct tm  

Converts the number of seconds to the UTC time in the tm structure. (This function is reentrant.)

localtime_r (const time_t restrict t, struct tm *restrict tm)

struct tm  

Converts the number of seconds to the local time in the tm structure. (This function is reentrant.)

asctime_r (const struct tm restrict tm, char *restrict buf)

char  

Converts the broken-down time in the tm structure into a string. (This function is reentrant.)

ctime_r (const time_t t, char buf)

char  

Converts the date and time into a string. (This function is reentrant.)

nanosleep (const struct timespec tspec1, struct timespec tspec2)

int 

Pauses the current thread until a specified time arrives.

clock_getres (clockid_t id, struct timespec tspec)

int 

Obtains the precision of a clock.

clock_gettime (clockid_t id, struct timespec tspec)

int 

Obtains the time of a clock.

clock_settime (clockid_t id, const struct timespec tspec)

int 

Sets the time for a clock.

clock_nanosleep (clockid_t id, int flag, const struct timespec tspec1, struct timespec tspec2)

int 

Pauses the current thread until a specified time of a clock arrives.

timer_create (clockid_t id, struct sigevent restrict evp, timer_t *restrict t)

int 

Creates a timer for the process.

timer_delete (timer_t t)

int 

Deletes a timer for the process.

timer_settime (timer_t t, int flags, const struct itimerspec __restrict val, struct itimerspec __restrict old)

int 

Sets a timer for the process.

timer_gettime (timer_t t, struct itimerspec tspec)

int 

Obtains a timer of the process.

timer_getoverrun (timer_t t)

int 

Obtains the number of times that a timer overruns.

strptime (const char s, const char format, struct tm tm)

char  

Converts a time string to the broken-down time in the tm structure.

getdate (const char buf)

struct tm  

Converts a time string to the broken-down time in the tm structure.

stime (const time_t t)

int 

Sets the system time.

timegm (struct tm *tm)

time_t 

Converts the broken-down time in the tm structure to the number of seconds.