ryan-haskell / elm-date-format

A reliable way to format dates with Elm.

elm-date-format

A reliable way to format dates with Elm.

DEPRECATED: There's a new version!

If you are able to use Elm 0.19, you should check out ryannhg/date-format.

That version will have the latest updates and features (like supporting multiple languages!)

Using the elm package

elm package install ryannhg/elm-date-format

What is elm-date-format?

If you're coming from Javascript, you might have heard of MomentJS.

MomentJS is a great library for formatting dates!

elm-date-format has the same formatting options as Moment, but uses Elm's awesome type system to provide human readable names, and catch typos for you at compile time!

No need to remember the difference between mm and MM and M!

A quick example

import Date exposing (Date)
import DateFormat


-- Create a custom formatter

yourFormatter : Date -> String
yourFormatter =
    DateFormat.format
        [ DateFormat.monthNameFull
        , DateFormat.text " "
        , DateFormat.dayOfMonthSuffix
        , DateFormat.text ", "
        , DateFormat.yearNumber
        ]


-- Using your formatter, format your date as a string!

yourPrettyDate : String
yourPrettyDate =
    case Date.fromString "2018-02-05T00:00:00.000" of
        Ok date ->
            yourFormatter date

        Err ->
            "This shouldn't happen..."

Would make yourPrettyDate return:

"February 5th, 2018" : String