The Calendar Library

The Calendar Library (Calendar for short) is an Objective Caml library for handling dates and times in your program.

Calendar mainly implements 3 datatypes:

  • Date: year/month/day with support for under-specified dates "year/month" or "year" only and support for Gregorian and Julian calendar
  • Time: hour/minute/second with support for time zones
  • Calendar: Date + Time
Seconds can be either integers or floats (different implementations are provided). The library also comes with:
  • Printers and parsers
  • Period: an interval between two dates or two times or two calendars

License & copyright

The code is free software: the license is LGPL (version 2.1), with the usual Ocaml linking exception.

Copyright © 2003-2011 Julien Signoles

Download and requirements

Calendar can be downloaded from the forge as usual.

Calendar requires Objective Caml 3.09.1 or higher. OCaml 3.09 is usable at your own risks. Older OCaml versions are unsupported.

The current version of the library is 2.03.2. See the list of changes.

Latest News

Calendar v2.04

Julien Signoles - 2014-10-30 07:10 -

Calendar 2.03.2 released

Julien Signoles - 2012-06-27 16:22 -

Calendar 2.03.1 released

Julien Signoles - 2011-03-25 16:44 -


The API documentation is available online. It is an ocamldoc documentation of the .mli files.

Some algorithms implemented in the library come from the online Calendar FAQ.

Project Summary



Powered By GForge Collaborative Development Environment