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

13.8.3 Time Functions

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

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