The cl-strftime Reference Manual

3.1.1 cl-strftime/cl-strftime.asd

Source

cl-strftime.asd.

Parent Component

cl-strftime (system).

ASDF Systems

cl-strftime.

---

3.1.2 cl-strftime/package.lisp

Source

cl-strftime.asd.

Parent Component

cl-strftime (system).

Packages

cl-strftime.

---

3.1.3 cl-strftime/time.lisp

Dependency

package.lisp (file).

Source

cl-strftime.asd.

Parent Component

cl-strftime (system).

Internals

• +storage-for-deflex-var-am/pm-hours+ (constant).
• +storage-for-deflex-var-century-years+ (constant).
• +storage-for-deflex-var-day-hours+ (constant).
• +storage-for-deflex-var-gmt+ (constant).
• +storage-for-deflex-var-gregorian-cycle+ (constant).
• +storage-for-deflex-var-hour-seconds+ (constant).
• +storage-for-deflex-var-leap-year-days+ (constant).
• +storage-for-deflex-var-month-days+ (constant).
• +storage-for-deflex-var-utc+ (constant).
• +storage-for-deflex-var-week-days+ (constant).
• +storage-for-deflex-var-year-days+ (constant).
• +storage-for-deflex-var-year-months+ (constant).
• +storage-for-deflex-var-zulu+ (constant).
• am/pm-hours (symbol macro).
• century-years (symbol macro).
• day (type).
• day-hours (symbol macro).
• gmt (symbol macro).
• gregorian-cycle (symbol macro).
• hour (type).
• hour-seconds (symbol macro).
• iso-long-year-table (symbol macro).
• iso-long-year? (function).
• iso-week (type).
• last-week (function).
• leap-year-days (symbol macro).
• minute (type).
• month (type).
• month-days (symbol macro).
• month-lengths (symbol macro).
• month-name (function).
• month-offset (function).
• month-offsets (symbol macro).
• months (symbol macro).
• second (type).
• short-month-name (function).
• short-months (symbol macro).
• short-weekday-name (function).
• short-weekdays (symbol macro).
• time (type).
• time-zone (type).
• universal-time (type).
• utc (symbol macro).
• week (type).
• week-days (symbol macro).
• weekday (type).
• weekday-name (function).
• weekdays (symbol macro).
• year (type).
• year-days (symbol macro).
• year-months (symbol macro).
• zulu (symbol macro).

---

3.1.4 cl-strftime/directives.lisp

Dependency

time.lisp (file).

Source

cl-strftime.asd.

Parent Component

cl-strftime (system).

Internals

• directive-action (type).
• find-directive (function).
• flag (type).
• time-directives (symbol macro).

---

3.1.5 cl-strftime/named-format.lisp

Dependency

directives.lisp (file).

Source

cl-strftime.asd.

Parent Component

cl-strftime (system).

Internals

• named-time-format (function).
• named-time-formats (symbol macro).

---

3.1.6 cl-strftime/math.lisp

Dependency

named-format.lisp (file).

Source

cl-strftime.asd.

Parent Component

cl-strftime (system).

Internals

• am/pm (function).
• am/pm-lowercase (function).
• century-of-year (function).
• day-of-year-number (function).
• extract-time-zone-abbrev (function).
• iso-8601-week-number (function).
• iso-8601-year (function).
• iso-8601-year-of-century (function).
• iso-day-of-week (function).
• iso-week+year (function).
• leap-year? (function).
• monday-week-number (function).
• o-clock (function).
• sunday-week-number (function).
• time-zone-name (function).
• time-zone-offset (function).
• time-zone-offset-with-colon (function).
• timestamp-day-of-year (function).
• week-number (function).
• year-of-century (function).

---

3.1.7 cl-strftime/cl-strftime.lisp

Dependency

math.lisp (file).

Source

cl-strftime.asd.

Parent Component

cl-strftime (system).

Public Interface

• format-time (compiler macro).
• format-time (function).
• make-time-formatter (function).

Internals

• *compiled-time-formats* (special variable).
• *default-width* (special variable).
• compile-directive (function).
• compile-flag (function).
• compile-flag-char (function).
• compile-formatter (function).
• compile-parsed-format (function).
• expand-tz (function).
• flatten! (function).
• make-time-formatter-1 (function).
• parse-format-string (function).
• writer (type).

---

5.1.1 Compiler macros

Compiler Macro: format-time (stream format &optional time tz) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

---

5.1.2 Ordinary functions

Function: format-time (stream format &optional time tz) ¶

Write TIME to STREAM as instructed by FORMAT.

TZ may be ‘nil’ (for the current default timezone), ‘t’ (for GMT), or an object of type ‘local-time::timezone’.

FLAGS

- Do not pad
_ Pad with spaces
0 Pad with zeros
# Toggle case
^ Upcase

DIRECTIVES

%% Literal percent sign
%A Weekday (Sunday)
%a Abbreviated weekday (Sun)
%B Month (January)
%b Abbreviated month (Jan)
%C Century (20)
%d Day of month (01-31)
%D Same as %m/%d/%y
%e Same as %_2d
%F Same as %Y-%m-%d
%G ISO 8601 year
%g ISO 8601 year in century
%h Same as %b
%H Hour (01–24)
%I Hour (01–12)
%j Day of year (001-366)
%k Hour ( 1-24)
%l Hour ( 1-12)
%m Month (01-12)
%M Minute (00-59)
%n Literal newline
%p AM or PM
%P am or pm
%r Same as %I:%M:%S %p
%R Same as %H:%M
%s Epoch time
%S Second (00-59)
%t Literal tab
%T Same as %H:%M:%S
%u Day of week (weeks start on Monday)
%U Week number
%V ISO 8601 week number
%w Day of week
%W Week number (weeks start on Monday)
%y Year of century (12)
%Y Year (2012)
%z RFC 2822 timezone
%Z Name of timezone

NAMED FORMATS

(Formats on the same line are synonyms.)

:ARPA :EMAIL :RFC-822
:ASCTIME :CTIME
:COOKIE
:HTTP :RFC-2616
:NEWS :RFC-850 :USENET
:RSS :RFC-2822 :RFC-1036 :RFC-2086
:RFC-1132
:UNIX
:W3C :HTML :RFC-3339 :XML :ATOM

Package

cl-strftime.

Source

cl-strftime.lisp.

Function: make-time-formatter (format) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

---

5.2.1 Constants

Constant: +storage-for-deflex-var-am/pm-hours+ ¶

Hours ante/post meridian.

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-century-years+ ¶

Years in a century.

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-day-hours+ ¶

Hours in a day.

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-gmt+ ¶

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-gregorian-cycle+ ¶

Length of a cycle in the Gregorian calendar.

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-hour-seconds+ ¶

Seconds in an hour.

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-leap-year-days+ ¶

Days in a leap year.

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-month-days+ ¶

Maximum number of days in a month.

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-utc+ ¶

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-week-days+ ¶

Days in a week.

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-year-days+ ¶

Days in a (non-leap) year.

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-year-months+ ¶

Months in a year.

Package

cl-strftime.

Source

time.lisp.

Constant: +storage-for-deflex-var-zulu+ ¶

Package

cl-strftime.

Source

time.lisp.

---

5.2.2 Special variables

Special Variable: *compiled-time-formats* ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Special Variable: *default-width* ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

---

5.2.3 Symbol macros

Symbol Macro: am/pm-hours ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: century-years ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: day-hours ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: gmt ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: gregorian-cycle ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: hour-seconds ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: iso-long-year-table ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: leap-year-days ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: month-days ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: month-lengths ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: month-offsets ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: months ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: named-time-formats ¶

Package

cl-strftime.

Source

named-format.lisp.

Symbol Macro: short-months ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: short-weekdays ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: time-directives ¶

Package

cl-strftime.

Source

directives.lisp.

Symbol Macro: utc ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: week-days ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: weekdays ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: year-days ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: year-months ¶

Package

cl-strftime.

Source

time.lisp.

Symbol Macro: zulu ¶

Package

cl-strftime.

Source

time.lisp.

---

5.2.4 Ordinary functions

Function: am/pm (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: am/pm-lowercase (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: century-of-year (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: compile-directive (flag width directive) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Function: compile-flag (flag width action) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Function: compile-flag-char (flag-char width action) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Function: compile-formatter (string) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Function: compile-parsed-format (format) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Function: day-of-year-number (y m d) ¶

Package

cl-strftime.

Source

math.lisp.

Function: expand-tz (tz) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Function: extract-time-zone-abbrev (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: find-directive (char &key noerror) ¶

Package

cl-strftime.

Source

directives.lisp.

Function: flatten! (list) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Function: iso-8601-week-number (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: iso-8601-year (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: iso-8601-year-of-century (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: iso-day-of-week (time) ¶

Return the day of week from 1–7, where 1 is Monday.

Package

cl-strftime.

Source

math.lisp.

Function: iso-long-year? (year) ¶

Package

cl-strftime.

Source

time.lisp.

Function: iso-week+year (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: last-week (year) ¶

Package

cl-strftime.

Source

time.lisp.

Function: leap-year? (y) ¶

Package

cl-strftime.

Source

math.lisp.

Function: make-time-formatter-1 (format force-gmt) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Function: monday-week-number (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: month-name (time) ¶

Package

cl-strftime.

Source

time.lisp.

Function: month-offset (m) ¶

Package

cl-strftime.

Source

time.lisp.

Function: named-time-format (name &optional gmt?) ¶

Package

cl-strftime.

Source

named-format.lisp.

Function: o-clock (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: parse-format-string (string) ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Function: short-month-name (time) ¶

Package

cl-strftime.

Source

time.lisp.

Function: short-weekday-name (time) ¶

Package

cl-strftime.

Source

time.lisp.

Function: sunday-week-number (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: time-zone-name (time &optional nato) ¶

Package

cl-strftime.

Source

math.lisp.

Function: time-zone-offset (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: time-zone-offset-with-colon (time) ¶

Package

cl-strftime.

Source

math.lisp.

Function: timestamp-day-of-year (time) ¶

The day of year of TIME, counting from 1.

Package

cl-strftime.

Source

math.lisp.

Function: week-number (time day-of-week) ¶

Package

cl-strftime.

Source

math.lisp.

Function: weekday-name (time) ¶

Package

cl-strftime.

Source

time.lisp.

Function: year-of-century (time) ¶

Package

cl-strftime.

Source

math.lisp.

---

5.2.5 Types

Type: day () ¶

A day of the month.

Package

cl-strftime.

Source

time.lisp.

Type: directive-action () ¶

Package

cl-strftime.

Source

directives.lisp.

Type: flag () ¶

Package

cl-strftime.

Source

directives.lisp.

Type: hour () ¶

An hour.

Package

cl-strftime.

Source

time.lisp.

Type: iso-week () ¶

Package

cl-strftime.

Source

time.lisp.

Type: minute () ¶

A minute.

Package

cl-strftime.

Source

time.lisp.

Type: month () ¶

A month.

Package

cl-strftime.

Source

time.lisp.

Type: second () ¶

A minute.

Package

cl-strftime.

Source

time.lisp.

Type: time () ¶

Package

cl-strftime.

Source

time.lisp.

Type: time-zone () ¶

Package

cl-strftime.

Source

time.lisp.

Type: universal-time () ¶

Package

cl-strftime.

Source

time.lisp.

Type: week () ¶

A week of the year.

Package

cl-strftime.

Source

time.lisp.

Type: weekday () ¶

A day of the week.

Package

cl-strftime.

Source

time.lisp.

Type: writer () ¶

Package

cl-strftime.

Source

cl-strftime.lisp.

Type: year () ¶

A year.

Package

cl-strftime.

Source

time.lisp.

---