Previous Page
Next Page

time

Obtains the current calendar time

#include <time.h>
time_t time ( time_t *timeptr  );

The time( ) function returns the current calendar time as a single arithmetic value. The return type, time_t, is defined in time.h, generally as long or unsigned long. If the argument is not a null pointer, the return value is also assigned to the location it references.

Many operating systems specify that the type time_t represents an integer number of seconds, and that the time( ) function returns the number of seconds passed since a specified epoch, such as midnight on January 1, 1970, Greenwich Mean Time. However, according to the C standard, neither of these conditions is required. The type time_t is an arithmetic type whose range and precision are defined by the implementation, as is the encoding of the time( ) function's return value.

Example

time_t sec;

time(&sec);
printf("This line executed at %.24s.\n", ctime(&sec));

This code produces the following output:

This line executed at Tue Mar 15 13:05:16 2005.

See also the examples at asctime( ), ctime( ), fprintf( ), freopen( ), gmtime( ), rand( ), and strftime( ) in this chapter.

See Also

asctime( ), ctime( ), gmtime( ), localtime( ), strftime( )


Previous Page
Next Page