Time

Modules
	Clock Functions
	Time Manipulation
	Time Unit Conversion

Macros
#define	timeForever   9223372036854775807LL
	Maximum representable time value (approximately year 294,276 CE)
#define	timeS(s)   timeFromSeconds(s)
#define	timeMS(ms)   timeFromMsec(ms)

Detailed Description

CX and related systems represent time as the number of microseconds since noon on January 1, 4713 BCE (UTC) - the Julian date epoch.

This provides an unambiguous time representation that:

• Covers dates from 4713 BCE through approximately 294,276 CE
• Uses a single 64-bit signed integer
• Has microsecond precision
• Is independent of time zones
• Does not require leap second handling

The time system includes:

• Clock functions for wall time and monotonic timers
• Conversion to/from standard C time types (time_t, timespec)
• Time decomposition and composition (TimeParts)
• Local time zone conversion

Macro Definition Documentation

timeMS

#define timeMS

(

ms

)

timeFromMsec(ms)

A time literal specified in milliseconds

Parameters

ms	Number of milliseconds

Returns

Time value in microseconds

Definition at line 23 of file time.h.

timeS

#define timeS

(

s

)

timeFromSeconds(s)

A time literal specified in seconds

Parameters

s	Number of seconds

Returns

Time value in microseconds

Definition at line 18 of file time.h.