GBBopen 1.5 Reference -- set-ot-base

set-ot-base

set-ot-base &optional date month year time-zone => ot-base [Function]

Purpose
Set the Offset Universal Time time-base value.

Package :gbbopen-tools

Module :gbbopen-tools

Arguments and values

date		An integer between 1 and up to 31, inclusive, depending on the month and year or `nil`, indicating the current date (default is `nil`)
month		An integer between 1 and 12, inclusive or `nil`, indicating the current month (default is `nil`)
year		An integer indicating the year A.D. or `nil`, indicating the current year (default is `nil`); if the `year` integer is between 0 and 99, the “obvious” year is assumed.
time-zone		A time zone: a rational multiple of 1/3600 between -24 and 24 that represents the number of hours offset from GMT (default is zero)

Returns
The Offset Universal Time time-base value

Description
Without any arguments, set-ot-base sets the time-base value to the current date. Setting the time base to the current date can be used in applications that do not need to represent historical dates and that do not save or communicate Offset Universal Time values. However, setting the time base to a specific date is recommended for most applications.

See also
    *ot-base*
    check-ot-base
    ot2ut
    ut2ot

Examples
Set the time base for Offset Universal Time to today:

  > (set-ot-base)
  3436662016
  >

Note that the returned Offset Universal Time time-base value (above) is not the current Universal Time value:

  > (get-universal-time)
  3419947437
  >

Set the time base for Offset Universal Time to July 1, 2007:

  > (set-ot-base 1 7 2007)
  3409014016
  >

The GBBopen Project

set-ot-base