User Tools


Function DECODE-UNIVERSAL-TIME

Syntax

  • decode-universal-time universal-time &optional time-zonesecond, minute, hour, date, month, year, day, daylight-p, zone

Arguments and Values

Description

Returns the decoded time represented by the given universal time. If time-zone is not supplied, it defaults to the current time zone adjusted for daylight saving time. If time-zone is supplied, daylight saving time information is ignored. The daylight saving time flag is nil if time-zone is supplied.

Examples

(decode-universal-time 0 0)

0 0 0 1 1 1900, 0 false 0

;;; The next two examples assume Eastern Daylight Time. (decode-universal-time 2414296800 5)

0 0 1 4 7 1976 6 false 5

(decode-universal-time 2414293200)

0 0 1 4 7 1976 6 true 5

;;; This example assumes that the time zone is Eastern Daylight Time (and that the time zone ;;; is constant throughout the example). (let* ((here (nth 8 (multiple-value-list (get-decoded-time)))) ; Time zone (recently (get-universal-time)) (daylight-zone-a (nthcdr 7 (multiple-value-list (decode-universal-time recently)))) (daylight-b (nthcdr 7 (multiple-value-list (decode-universal-time recently here))))) (list daylight-zone-a daylight-zone-b (equal daylight-zone-a daylight-zone-b)))

((T 5) (NIL 5) NIL)

Affected By

Implementation-dependent mechanisms for calculating when or if daylight savings time is in effect for any given session.

Exceptional Situations

None.

See Also

Notes

None.

\issue{TIME-ZONE-NON-INTEGER:ALLOW} \issue{DECODE-UNIVERSAL-TIME-DAYLIGHT:LIKE-ENCODE} \issue{DECODE-UNIVERSAL-TIME-DAYLIGHT:LIKE-ENCODE}