Next: Time Constructor Functions, Previous: Date Constructor Functions, Up: The Date And Time Library [Index]

All time reporting functions report the absolute time value (as if time would
be positively defined). Time orientation (or sign, or signedness) may be
obtained via ‘`t_sign`’.

integer t_compare(time t, time s);

is 0 if *t* is same as *s*, less than 0 if *t* is less than
*s* and greater than 0 if *t* is greater than *s*

void t_copy(time t, time s);

sets *t* to *s*

integer t_d_hour(time t);

is the *t* hour of the day (0 .. 23)

integer t_day(time t);

is the *t* day

time t_ddiff(time t, date d, date e);

is *t*, sets *t* to the *d* *e* difference (the sign of the
difference is preserved)

time t_fix(time t, integer second, integer microsecond);

is *t*, sets *t* to *second* seconds and *microsecond*
seconds. The absolute value of *microsecond* is not restricted to the 0
.. 999999 range. Both *second* and *microsecond* may be negatively
defined.

integer t_h_minute(time t);

is the *t* minute of the hour (0 .. 59)

integer t_m_second(time t);

is the *t* second of the minute (0 .. 60)

integer t_microsecond(time t);

is the *t* microsecond

void t_new(time &t);

sets *t* as a new time object (does nothing if *t* is not linked
multiple times, creates a new object and sets *t* as a reference of that
object if it is)

integer t_s_frame(time t);

is the *t* frame of the second (0 .. 59) (here *frame* is the
sixtieth part of the second)

integer t_second(time t);

is the *t* second

time t_set(time &t, time h);

is *h*, sets the *t* time object as a reference of the *h* time
object

integer t_sign(time t);

is -1 if *t* is negatively defined, 1 if *t* is (strictly) positively
defined and zero if *t* is zero