Function: org-decode-time

org-decode-time is a for decode-time, defined in timefns.c.

This function is obsolete since 9.6; use decode-time instead.

Signature

(org-decode-time &optional TIME ZONE FORM)

Documentation

Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST UTCOFF).

The optional TIME is the time value to convert. See format-time-string for the various forms of a time value.

The optional ZONE is omitted or nil for Emacs local time, t for Universal Time, wall for system wall clock time, or a string as in the TZ environment variable. It can also be a list (as from current-time-zone) or an integer (the UTC offset in seconds) applied without consideration for daylight saving time.

The optional FORM specifies the form of the SEC member. If integer, SEC is an integer; if t, SEC is an integer or (TICKS . HZ) timestamp with the same precision as TIME. An omitted or nil FORM is currently treated like integer, but this may change in future Emacs versions.

To access (or alter) the elements in the time value, the decoded-time-second, decoded-time-minute, decoded-time-hour, decoded-time-day, decoded-time-month, decoded-time-year, decoded-time-weekday, decoded-time-dst and decoded-time-zone accessors can be used.

The list has the following nine members: SEC is an integer or Lisp timestamp representing a nonnegative value less than 60
(or less than 61 if the operating system supports leap seconds).
MINUTE is an integer between 0 and 59. HOUR is an integer between 0 and 23. DAY is an integer between 1 and 31. MONTH is an integer between 1 and 12. YEAR is the year number, an integer; 0 represents 1 BC. DOW is the day of week, an integer between 0 and 6, where 0 is Sunday. DST is t if daylight saving time is in effect, nil if it is not in effect, and -1 if daylight saving information is not available. UTCOFF is an integer indicating the UTC offset in seconds, i.e., the number of seconds east of Greenwich. (Note that Common Lisp has different meanings for DOW and UTCOFF, and its SEC is always an integer between 0 and 59.)

Aliases

org-decode-time (obsolete since 9.6)