This is the format-seconds Reference Manual, version 0.0.1, generated automatically by Declt version 4.0 beta 2 "William Riker" on Fri May 15 12:19:07 2026 GMT+0.
The main system appears first, followed by any subsystem dependency.
format-secondsFormat durations in seconds as human-friendly strings
contrapunctus
Unlicense
0.0.1
cl-ppcre (system).
src/ (module).
Modules are listed depth-first from the system components tree.
format-seconds/src/format-seconds (system).
package.lisp (file).
units.lisp (file).
core.lisp (file).
Files are sorted by type and then listed depth-first from the systems components trees.
format-seconds/format-seconds.asdformat-seconds/src//package.lispformat-seconds/src//units.lispformat-seconds/src//core.lispformat-seconds/format-seconds.asdformat-seconds (system).
format-seconds/src//units.lisppackage.lisp (file).
src/ (module).
*units* (special variable).
directive (reader method).
(setf directive) (writer method).
make-unit (function).
name (reader method).
(setf name) (writer method).
seconds (reader method).
(setf seconds) (writer method).
unit (class).
default-units (function).
format-seconds/src//core.lispunits.lisp (file).
src/ (module).
format-seconds (function).
*debug* (special variable).
debug-format (function).
format-seconds-1 (function).
Packages are listed by definition order.
format-secondscommon-lisp.
*units* (special variable).
directive (generic reader).
(setf directive) (generic writer).
format-seconds (function).
make-unit (function).
name (generic reader).
(setf name) (generic writer).
seconds (generic reader).
(setf seconds) (generic writer).
unit (class).
*debug* (special variable).
debug-format (function).
default-units (function).
format-seconds-1 (function).
Definitions are sorted by export status, category, package, and then by lexicographic order.
List of ‘unit’ instances, in decreasing order of size.
Use FORMAT-STRING to format the number SECONDS.
The valid format specifiers are -
~y is the number of (365-day) years.
~o is the number of (30-day) months.
~w is the number of weeks.
~d is the number of days.
~h is the number of hours.
~m is the number of minutes.
~s is the number of seconds.
~z is a non-printing control flag (see below).
~~ is a literal "~".
Upper-case specifiers are followed by the unit-name (e.g. "years").
Lower-case specifiers return only the unit.
"~" may be followed by any prefix parameters and "’" and/or "@",
as acceptable to the ~D ‘format’ directive.
The "~z" specifier does not print anything. When it is used, specifiers must be given in order of decreasing size. To the left of "~z", nothing is output until the first non-zero unit is encountered.
The name of this unit as singular word.
string
(error "empty `name' slot.")
:name
name.
The string (without the ~ prefix) used
to specify this unit in the control string.
string
(error "empty `directive' slot.")
:directive
How many seconds this unit is equivalent to.
integer
(error "empty `seconds' slot.")
:seconds
If non-nil, print debugging information to *debug-io*.
Return a list of default units.
Return the result of dividing SECONDS by DIVISOR as a string.
PREFIX-PARAMS is a string acceptable to the "~D" directive in
‘format’.
If UNIT is non-nil, it is inserted after the string. If SECONDS is 0 or >1, UNIT is suffixed with "s". e.g. if UNIT is "second", values of 0, 1 and 2 SECONDS will result in "0 seconds", "1 second", and "2 seconds" respectively.
| Jump to: | (
D F G M N S |
|---|
| Jump to: | (
D F G M N S |
|---|
| Jump to: | *
D N S |
|---|
| Jump to: | *
D N S |
|---|
| Jump to: | C F M P S U |
|---|
| Jump to: | C F M P S U |
|---|