A time object has type, seconds and nanoseconds fields representing a point in time starting from some epoch. This is an arbitrary point in time, not just a time of day. Although times are represented in nanoseconds, the actual resolution may be lower.
The following variables hold the possible time types. For instance
(current-time time-process) would give the current CPU process
Universal Coordinated Time (UTC).
International Atomic Time (TAI).
Monotonic time, meaning a monotonically increasing time starting from an unspecified epoch.
Note that in the current implementation
time-monotonic is the
time-tai, and unfortunately is therefore affected by
adjustments to the system clock. Perhaps this will change in the
A duration, meaning simply a difference between two times.
CPU time spent in the current process, starting from when the process began.
CPU time spent in the current thread. Not currently implemented.
#t if obj is a time object, or
#f if not.
Create a time object with the given type, seconds and nanoseconds.
Get or set the type, seconds or nanoseconds fields of a time object.
set-time-type! merely changes the field, it doesn’t convert the
time value. For conversions, see SRFI-19 Time/Date conversions.
Return a new time object, which is a copy of the given time.
Return the current time of the given type. The default
Note that the name
current-time conflicts with the Guile core
current-time function (see Time) as well as the SRFI-18
current-time function (see SRFI-18 Time). Applications
wanting to use more than one of these functions will need to refer to
them by different names.
Return the resolution, in nanoseconds, of the given time type.
The default type is
#f according to the respective relation
between time objects t1 and t2. t1 and t2
must be the same time type.
Return a time object of type
time-duration representing the
period between t1 and t2. t1 and t2 must be
the same time type.
time-difference returns a new time object,
time-difference! may modify t1 to form its return.
Return a time object which is time with the given duration
added or subtracted. duration must be a time object of type
subtract-duration return a new time
subtract-duration! may modify
the given time to form their return.