README.md

# CalendarInterval

[![Build Status](https://travis-ci.org/wojtekmach/calendar_interval.svg?branch=master)](https://travis-ci.org/wojtekmach/calendar_interval)

Functions for working with calendar intervals.

Key ideas:
* Time is enumerable: "2018" is a collection of "2018-01/2018-12" months, "2018-01-01/2018-12-31" days etc
* Everything is an interval: "2018" is an interval of 1 year, or 12 months, or 365 days etc.
  A timestamp with microsecond precision is an interval 1 microsecond long
* Allen's Interval Algebra: formalism for relations between time intervals

## Examples

```elixir
use CalendarInterval

iex> ~I"2018-06".precision
:month

iex> CalendarInterval.next(~I"2018-12-31")
~I"2019-01-01"

iex> CalendarInterval.nest(~I"2018-06-15", :minute)
~I"2018-06-15 00:00/23:59"

iex> CalendarInterval.relation(~I"2018-01", ~I"2018-02/12")
:meets

iex> Enum.count(~I"2016-01-01/12-31")
366
```

## References

This library is heavily inspired by "Exploring Time" talk by Eric Evans [1] where
he mentioned the concept of "Countable Time" and introduced me to
"Allen's Interval Algebra" [2].

- [1] <https://www.youtube.com/watch?v=Zm95cYAtAa8>
- [2] <https://www.ics.uci.edu/~alspaugh/cls/shr/allen.html>

I've also given a talk about some of these ideas at Empex NYC 2018:
[video](https://www.youtube.com/watch?v=vUOA5GgYg9I),
[slides](https://speakerdeck.com/wojtekmach/recurrences-and-intervals).

## Installation

Add to `mix.exs`:

```elixir
def deps do
  [
    {:calendar_interval, "~> 0.2.0"}
  ]
end
```

## License

[Apache 2.0](./LICENSE.md)