package lunar

You can search for identifiers within the package.

in-package search v0.2.0

On This Page

Components
Absolute elements
Relative elements
Resolution and Duration
Ranges
Reusable signatures

A very small date management library

Install

dune-project

Dependency

github.com Readme Changelog Edit opam file Versions (3)

Authors

Maintainers

Sources

lunar-1.1.0.tbz

sha256=f158deac67b864f3edd7d1242b3340a0f218d4465b9e4108501a02197594d0f9

sha512=acf9a3ea508c3df2351aec6ea8299583be128f02d2d891ab82a2999ad6ba00c967962ede7d96782c27a7edcb7f78db08380293a8bf044a567a749872bbc417a8

doc/lunar/Lunar/index.html

Module `Lunar`Source

Lunar is a minimal date and time library, based primarily on a proleptic Gregorian calendar, that focuses on simple operations. Its development is needs-driven, meaning that the library is open to contributions that add use cases not initially considered.

In particular, the library allows you to work with Time objects (a specific hour of the day), Date objects (a specific day of the year), Datetime objects (a combination of a Time and a Date), and Zoned_datetime objects (a Datetime associated with a Timezone).

The code (and the algorithms used) is designed to be as simple as possible and easy to extend (without any particular concern for performance... sorry).

Components

Describes the low-level components used as utilities for describing dates.

Sourcemodule Era : sig ... end

Era identifies the historical period relative to year numbering. In the Gregorian/ISO calendar there are two eras: BCE and CE. Since Lunar just support dates between the years 0000 (in an astronomic sense), BCE is probably never used.

Sourcemodule Month : sig ... end

Representation of the months of the year, using an enumeration.

Sourcemodule Weekday : sig ... end

Representation of the days of a week, using an enumeration.

Absolute elements

All objects that are not associated with a time zone.

Sourcemodule Time : sig ... end

Represents a time from 00:00:00 to 23:59:59.

Sourcemodule Date : sig ... end

Represents a date (year, month, day).

Sourcemodule Datetime : sig ... end

Represents a Datetime. A Date.t associated with a Time.t.

Relative elements

Objects associated with a time zone.

Sourcemodule Timezone : sig ... end

Describes the offset of a time zone, used to describe time-zone datetime values.

Sourcemodule Zoned_datetime : sig ... end

A Datetime.t associated with a Timezone.t.

Resolution and Duration

The resolution allows you to truncate dates (and more). And durations are a low-level representation of a number of seconds.

Sourcemodule Resolution : sig ... end

Describes a resolution that allows, among other things, dates to be truncated. Since negative resolutions produce strange results, they are always converted to their absolute values.

Sourcemodule Duration : sig ... end

Describes a duration in seconds (Lunar is essentially a Calendar library, so greater precision does not seem particularly useful). This is the most primitive type in the library, and the API exposes minimal set of arithmetic operations.

Ranges

Provides a generic way to describe orderable and iterable ranges.

Sourcemodule Range : sig ... end

The Range module allows you to create intervals between comparable data points (implementing Sigs.COMPARABLE).

Reusable signatures

module Sigs : sig ... end

Set of reusable signatures for sharing behaviors, among other things.