Hour

This Elm package provides a simple Hour type for working with local hours.

Installation

elm install justinmimbs/date

Overview

Get the current local time: now
Get times from Posix times: fromPosix
Convert Hour.Time values both to and from:
    ISO times (12:30:05)
    Raw parts ({ hours, minutes, seconds, millis })
Format times for display: format, formatWithLanguage
Manipulate times: add, floor, ceiling
Diff times: diff
Create lists of times: range
Helpers: compare, isBetween, min, max, clamp

Examples

These examples are only meant to give a feel for the library; see the docs for the full API. Create a time and format it:

import Hour


Hour.time (13, 30, 0)
    |> Hour.format "hh'h and' mm 'minutes'"
    --> "01h and 30 minutes"

Basic arithmetic with hours:

import Hour exposing (Interval(..), Unit(..))
import Time exposing (Month(..))


Hour.time (9, 23, 0)
    |> Hour.floor Quarter
    |> Hour.add Hours 8
    |> Hour.toIsoString
    == "17:15"

List all times in a 45 minutes interval for all working hours:

import Hour exposing (Interval(..), Unit(..))


Hour.range Minute 45 (Hour.time (9, 0, 0)) (Hour.time (16, 0, 0))
    |> List.map Hour.toIsoString
    --> ["09:00", "09:45", "10:30", "11:15", "12:00", "12:45", "13:30", "14:15", "15:00", "15:45"]