#[1]Top [2]Concept Index [3]Table of Contents [4]SRFI-19 [5]SRFI-19 Date
   [6]SRFI-19 Introduction

   Next: [7]SRFI-19 Date, Previous: [8]SRFI-19 Introduction, Up: [9]SRFI-19 -
   Time/Date Library   [[10]Contents][[11]Index]
     ____________________________________________________________________________

7.5.16.2 SRFI-19 Time

   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 time.

   Variable: time-utc[12] ¶
          Universal Coordinated Time (UTC).

   Variable: time-tai[13] ¶
          International Atomic Time (TAI).

   Variable: time-monotonic[14] ¶
          Monotonic time, meaning a monotonically increasing time starting from an
          unspecified epoch.

          Note that in the current implementation time-monotonic is the same as
          time-tai, and unfortunately is therefore affected by adjustments to the
          system clock. Perhaps this will change in the future.

   Variable: time-duration[15] ¶
          A duration, meaning simply a difference between two times.

   Variable: time-process[16] ¶
          CPU time spent in the current process, starting from when the process
          began.

   Variable: time-thread[17] ¶
          CPU time spent in the current thread. Not currently implemented.

   Function: time? obj[18] ¶
          Return #t if obj is a time object, or #f if not.

   Function: make-time type nanoseconds seconds[19] ¶
          Create a time object with the given type, seconds and nanoseconds.

   Function: time-type time[20] ¶
   Function: time-nanosecond time[21] ¶
   Function: time-second time[22] ¶
   Function: set-time-type! time type[23] ¶
   Function: set-time-nanosecond! time nsec[24] ¶
   Function: set-time-second! time sec[25] ¶
          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 [26]SRFI-19 Time/Date conversions.

   Function: copy-time time[27] ¶
          Return a new time object, which is a copy of the given time.

   Function: current-time [type][28] ¶
          Return the current time of the given type. The default type is time-utc.

          Note that the name current-time conflicts with the Guile core current-time
          function (see [29]Time) as well as the SRFI-18 current-time function (see
          [30]SRFI-18 Time). Applications wanting to use more than one of these
          functions will need to refer to them by different names.

   Function: time-resolution [type][31] ¶
          Return the resolution, in nanoseconds, of the given time type. The default
          type is time-utc.

   Function: time