# Number and Currency Localization and Formatting
![Build Status](
![Deps Status](
[![Hex pm](](

## Introduction and Getting Started

[ex_cldr_numbers]( is an addon library application for [ex_cldr]( that provides localization and formatting for numbers and currencies.

The primary api is `Cldr.Number.to_string/2`.  The following examples demonstrate:

iex> Cldr.Number.to_string 12345
{:ok, "12,345"}

iex> Cldr.Number.to_string 12345, locale: "fr"
{:ok, "12 345"}

iex> Cldr.Number.to_string 12345, locale: "fr", currency: "USD"
{:ok, "12 345,00 $US"}

iex> Cldr.Number.to_string 12345, format: "#E0"
{:ok, "1.2345E4"}

For help in `iex`:

iex> h Cldr.Date.to_string
iex> h Cldr.Time.to_string
iex> h Cldr.DateTime.to_string
iex> h Cldr.DateTime.Relative.to_string
## Documentation

Primary documentation is available on [as part of the ex_cldr documentation on hex](

## Known restrictions and limitations

## Installation

Note that [ex_cldr_numbers]( requires Elixir 1.5 or later.

Add `ex_cldr_numbers` as a dependency to your `mix` project:

    defp deps do
        {:ex_cldr_numbers, "~> 0.1.0"}

then retrieve `ex_cldr_numbers` from [hex](

    mix deps.get
    mix deps.compile