Gets the system time.

#include <time.h>

/* generic time (see Remarks) */
time_t time(time_t *timer);
 
/* 32 bit time */
__time32_t  _time32(__time32_t * t);

/* 64 bit time */
__time64_t  _time64(__time64_t * t);

Parameters

timer

Storage location for the return value. This parameter may be a null pointer, in which case the return value is not stored.

Remarks

This functions get the RT system time and adds an adjustment factor: the number of seconds between epoch time and RT subsystem boot time, plus the local timezone factor TZ, described in tzset. This adjusts the RT time value to a POSIX-standard value.

time() is a wrapper for _time32() and time_t is, by default, equivalent to __time32_t. If you need to force the compiler to interpret time_t as the new 64-bit time_t, you can define _USE_64BIT_TIME_T. This is recommended to ensure that your application does not fail after January 18, 2038, but is not backwards-compatible with previous versions of INtime.

Return Values

The number of seconds elapsed since midnight on January 1, 1970, or -1 in the case of failure.

Requirements