ToC DocOverview CGDoc RelNotes Index PermutedIndex
Allegro CL
Home Previous Up Next Table of Contents Index
  ANSI Common Lisp   25 Environment   25.1 The External Environment   25.1.4 Time

25.1.4.1 Decoded Time

A decoded time is an ordered series of nine values that, taken together, represent a point in calendar time (ignoring leap seconds):

  • Second

    An integer between 0 and 59, inclusive.

  • Minute

    An integer between 0 and 59, inclusive.

  • Hour

    An integer between 0 and 23, inclusive.

  • Date

    An integer between 1 and 31, inclusive (the upper limit actually depends on the month and year, of course).

  • Month

    An integer between 1 and 12, inclusive; 1 means January, 2 means February, and so on; 12 means December.

  • Year

    An integer indicating the year A.D. However, if this integer is between 0 and 99, the "obvious" year is used; more precisely, that year is assumed that is equal to the integer modulo 100 and within fifty years of the current year (inclusive backwards and exclusive forwards). Thus, in the year 1978, year 28 is 1928 but year 27 is 2027. (Functions that return time in this format always return a full year number.)

  • Day of week

    An integer between 0 and 6, inclusive; 0 means Monday, 1 means Tuesday, and so on; 6 means Sunday.

  • Daylight saving time flag

    A generalized boolean that, if true, indicates that daylight saving time is in effect.

  • Time zone

    A time zone.

The next figure shows defined names relating to decoded time.

Defined names involving time in Decoded Time.
decode-universal-time get-decoded-time

Home Previous Up Next Table of Contents Index
© Franz Inc. 1998-2005 - File last updated 6-21-2002