This is the calendar-times Reference Manual, generated automatically by Declt version 4.0 beta 2 "William Riker" on Fri May 15 11:38:05 2026 GMT+0.
The main system appears first, followed by any subsystem dependency.
calendar-timesA calendar times library on top of local-time
Mariano Montone <marianomontone@gmail.com>
local-time (system).
alexandria (system).
uiop (system).
split-sequence (system).
closer-mop (system).
calendar-times.lisp (file).
Files are sorted by type and then listed depth-first from the systems components trees.
calendar-times/calendar-times.asdcalendar-times (system).
calendar-times/calendar-times.lispcalendar-times (system).
+days-per-week+ (constant).
+hours-per-day+ (constant).
+minutes-per-day+ (constant).
+minutes-per-hour+ (constant).
+months-per-year+ (constant).
+seconds-per-day+ (constant).
+seconds-per-hour+ (constant).
+seconds-per-minute+ (constant).
caltime (class).
caltime+ (generic function).
caltime- (generic function).
caltime->local-time (generic function).
caltime->universal-time (function).
caltime-adjust (function).
caltime-coerce (generic function).
caltime-difference (generic function).
caltime-equalp (generic function).
caltime< (function).
caltime<= (function).
caltime= (function).
caltime> (function).
caltime>= (function).
caltimes-compose (function).
clone-caltime (generic function).
date (class).
datetime (class).
datetime-date (function).
datetime-time (function).
day-of (reader method).
day-of-week (function).
decode-caltime (generic function).
format-caltime (generic function).
hour-of (reader method).
make-date (function).
make-datetime (function).
make-time (function).
make-zoned-date (function).
make-zoned-datetime (function).
minutes-of (reader method).
month-of (reader method).
now (function).
parse-timestring (generic function).
print-object (method).
seconds-of (reader method).
time-now (function).
timezone-of (reader method).
today (function).
universal->caltime (generic function).
universal->date (function).
universal->walltime (function).
walltime (class).
year-of (reader method).
zoned-date (class).
zoned-datetime (class).
%caltimes-compose (generic function).
+date-format+ (special variable).
+datetime-format+ (special variable).
+day-names+ (special variable).
+time-format+ (special variable).
+zoned-date-format+ (special variable).
+zoned-datetime-format+ (special variable).
caltime-compare (generic function).
convert-units (generic function).
copy-instance (generic function).
date->local-time (function).
datetime->local-time (function).
ensure-timezone (function).
local-time->caltime (generic function).
local-time->date (function).
local-time->walltime (function).
make-gmt-offset-timezone (function).
offset->string (function).
parse-date (function).
parse-datetime (function).
parse-time (function).
parse-zoned-datetime (function).
time->local-time (function).
zoned-caltime (class).
zoned-date->local-time (function).
zoned-datetime->local-time (function).
Packages are listed by definition order.
calendar-timesCALENDAR-TIMES is a calendar time library implemented on top of LOCAL-TIME library.
It features zoned calendar times and calculations.
caltimes
common-lisp.
+days-per-week+ (constant).
+hours-per-day+ (constant).
+minutes-per-day+ (constant).
+minutes-per-hour+ (constant).
+months-per-year+ (constant).
+seconds-per-day+ (constant).
+seconds-per-hour+ (constant).
+seconds-per-minute+ (constant).
caltime (class).
caltime+ (generic function).
caltime- (generic function).
caltime->local-time (generic function).
caltime->universal-time (function).
caltime-adjust (function).
caltime-coerce (generic function).
caltime-difference (generic function).
caltime-equalp (generic function).
caltime< (function).
caltime<= (function).
caltime= (function).
caltime> (function).
caltime>= (function).
caltimes-compose (function).
clone-caltime (generic function).
date (class).
datetime (class).
datetime-date (function).
datetime-time (function).
day-of (generic reader).
day-of-week (function).
decode-caltime (generic function).
format-caltime (generic function).
hour-of (generic reader).
make-date (function).
make-datetime (function).
make-time (function).
make-zoned-date (function).
make-zoned-datetime (function).
minutes-of (generic reader).
month-of (generic reader).
now (function).
parse-timestring (generic function).
seconds-of (generic reader).
time-now (function).
timezone-of (generic reader).
today (function).
universal->caltime (generic function).
universal->date (function).
universal->walltime (function).
walltime (class).
year-of (generic reader).
zoned-date (class).
zoned-datetime (class).
%caltimes-compose (generic function).
+date-format+ (special variable).
+datetime-format+ (special variable).
+day-names+ (special variable).
+time-format+ (special variable).
+zoned-date-format+ (special variable).
+zoned-datetime-format+ (special variable).
caltime-compare (generic function).
convert-units (generic function).
copy-instance (generic function).
date->local-time (function).
datetime->local-time (function).
ensure-timezone (function).
local-time->caltime (generic function).
local-time->date (function).
local-time->walltime (function).
make-gmt-offset-timezone (function).
offset->string (function).
parse-date (function).
parse-datetime (function).
parse-time (function).
parse-zoned-datetime (function).
time->local-time (function).
zoned-caltime (class).
zoned-date->local-time (function).
zoned-datetime->local-time (function).
Definitions are sorted by export status, category, package, and then by lexicographic order.
Convert CALTIME to UNIVERSAL-TIME.
Returns T when the caltimes represent the same point in time.
Compose caltimes.
For example, a date + a time = datetime; a date-time + timezone = zoned-datetime..
Returns the DATE of DATETIME
Returns the WALLTIME of DATETIME.
Return day of week of CALTIME.
FORMAT can be either :NUMBER (default) or :NAME.
Create a date object from DAY, MONTH and YEAR.
Create a date and time object.
Create a time object.
Create a date with a timezone.
Create a datetime with a timezone.
The ZONED-DATETIME now.
The WALLTIME now.
Returns DATE today.
Convert UNIVERSAL-TIME to DATE
Convert UNIVERSAL-TIME to WALLTIME
zoned-datetime) amount unit &rest more) ¶Return a new caltime from CALTIME reduced in AMOUNT UNITs.
Example:
(caltime- (now) 2 :day)
zoned-datetime) amount unit &rest more) ¶Generic caltime to local-time conversion.
zoned-datetime)) ¶zoned-date)) ¶Convert between different classes of time types.
zoned-datetime) (class (eql calendar-times:datetime)) &rest args) ¶datetime) (class (eql calendar-times:zoned-datetime)) &rest args) ¶Difference between caltimes, in UNITs.
Compare calendar times for equality.
This is a structural equality comparison. So, two caltimes that represent
the same point in time, but differ in one of its elements (for instance, its timezone), are considered different. Use CALTIME= for equality for caltimes that
represent the same point in time.
zoned-datetime) (t2 zoned-datetime)) ¶Decode a CALTIME parts and return them with VALUES.
The order of the list of values is the same as passed to the constructor functions.
zoned-datetime)) ¶Format CALTIME.
Destination can be T, then timestring is written to *STANDARD-OUTPUT*;
can be NIL, then a string is returned;
or can be a stream.
zoned-date) &optional format &rest args) ¶zoned-datetime) &optional format &rest args) ¶Parse TIMESTRING and return an instance of CLASS.
CLASS should be the class name of one of the subclasses of CALTIME.
string) (class (eql calendar-times:zoned-datetime)) &rest args) ¶string) (class (eql calendar-times:datetime)) &rest args) ¶string) (class (eql time)) &rest args) ¶string) (class (eql calendar-times:walltime)) &rest args) ¶string) (class (eql calendar-times:date)) &rest args) ¶zoned-caltime)) ¶Timezone can be a LOCAL-TIME::TIMEZONE object, or an offset.
UNIVERSAL to CALTIME conversion
symbol)) ¶Convert UNIVERSAL-TIME to CALTIME.
Abstract calendar time class
A date like 2024-01-01
A datetime like 2024-01-01T00:00:00
Represents a ’wall’ time. Like 01:01:22
A date with a timezone.
A datetime with a timezone.
Create a GMT + OFFSET timezone. OFFSET is in seconds.
Format OFFSET. OFFSET is in seconds.
Convert WALLTIME to LOCAL-TIME:TIMESTAMP.
(eql :hours)) (to-unit (eql :seconds))) ¶(eql :hours)) (to-unit (eql :minutes))) ¶(eql :minutes)) (to-unit (eql :seconds))) ¶(eql :seconds)) (to-unit (eql :hours))) ¶(eql :minutes)) (to-unit (eql :hours))) ¶(eql :seconds)) (to-unit (eql :minutes))) ¶Makes and returns a shallow copy of OBJECT.
An uninitialized object of the same class as OBJECT is allocated by
calling ALLOCATE-INSTANCE. For all slots returned by
CLASS-SLOTS, the returned object has the
same slot values and slot-unbound status as OBJECT.
REINITIALIZE-INSTANCE is called to update the copy with INITARGS.
standard-object) &rest initargs &key &allow-other-keys) ¶A calendar time with timezone. Abstract class.
Timezone can be a LOCAL-TIME::TIMEZONE object, or an offset.
(or local-time::timezone integer)
local-time:+utc-zone+
This slot is read-only.
| Jump to: | %
C D E F G H L M N O P S T U Y Z |
|---|
| Jump to: | %
C D E F G H L M N O P S T U Y Z |
|---|
| Jump to: | +
C D H M S T Y |
|---|
| Jump to: | +
C D H M S T Y |
|---|
| Jump to: | C D F P S W Z |
|---|
| Jump to: | C D F P S W Z |
|---|