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


13.9.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’.

t_compare

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

t_copy

time t_copy(time t, time s);

is t, sets t to s

t_d_hour

integer t_d_hour(time t);

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

t_day

integer t_day(time t);

is the t day

t_ddiff

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)

t_fix

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

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

t_h_minute

integer t_h_minute(time t);

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

t_m_second

integer t_m_second(time t);

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

t_microsecond

integer t_microsecond(time t);

is the t microsecond

t_new

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)

t_real

real t_real(time t);

is ‘t_second’(t) + ‘t_microsecond’(t) / 1000000

t_s_frame

integer t_s_frame(time t);

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

t_second

integer t_second(time t);

is the t second

t_set

time t_set(time &t, time h);

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

t_sign

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: Time Constructor Functions, Previous: Date Constructor Functions, Up: The Date And Time Library   [Index]