# handlebars-intl

> Handlebars helpers for internationalization.

Latest version **1.1.2** (published 2016-01-28) · BSD-3-Clause license · 0 weekly downloads

## Install

```sh
npm install handlebars-intl
pnpm add handlebars-intl
yarn add handlebars-intl
bun add handlebars-intl
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.2 |
| Published | 2016-01-28 |
| First published | 2014-09-22 |
| Weekly downloads | 0 |
| License | BSD-3-Clause |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 261 |
| Author | Eric Ferraiuolo |
| Maintainers | ericf, caridy |
| Keywords | intl, i18n, handlebars |

## Links

- npm: https://www.npmjs.com/package/handlebars-intl
- Repository: https://github.com/yahoo/handlebars-intl
- Issues: https://github.com/yahoo/handlebars-intl/issues
- npm.io page: https://npm.io/package/handlebars-intl

## Dependencies (3)

- [intl-format-cache](https://npm.io/package/intl-format-cache.md) 2.0.5
- [intl-messageformat](https://npm.io/package/intl-messageformat.md) 1.1.0
- [intl-relativeformat](https://npm.io/package/intl-relativeformat.md) 1.1.0

## Alternatives

- [messageformat](https://npm.io/package/messageformat.md) — 329.7K weekly downloads
- [@mintlify/scraping](https://npm.io/package/@mintlify/scraping.md) — 294.8K weekly downloads
- [@mintlify/previewing](https://npm.io/package/@mintlify/previewing.md) — 209.5K weekly downloads
- [@mintlify/prebuild](https://npm.io/package/@mintlify/prebuild.md) — 209.5K weekly downloads
- [@mintlify/link-rot](https://npm.io/package/@mintlify/link-rot.md) — 206.3K weekly downloads

## Recent versions

- 1.1.2 (latest) — 2016-01-28
- 1.1.1 — 2015-03-23
- 1.1.0 — 2015-03-20
- 1.0.1 — 2014-12-12
- 1.0.0 — 2014-10-07
- 1.0.0-rc-5 — 2014-09-26
- 1.0.0-rc-4 — 2014-09-23
- 1.0.0-rc-3 — 2014-09-22

## README

[Handlebars Intl][]
===================

This library provides [Handlebars][] helpers for internationalization. The helpers provide a declarative way to format dates, numbers, and string messages with pluralization support.

[![npm Version][npm-badge]][npm]
[![Build Status][travis-badge]][travis]
[![Dependency Status][david-badge]][david]

[![Sauce Test Status][sauce-badge]][sauce]

**This package used to be named `handlebars-helper-intl`.**


Overview
--------

**Handlebars Intl is part of [FormatJS][], the docs can be found on the webiste:**
**<http://formatjs.io/handlebars/>**

### Features

- Display numbers with separators.
- Display dates and times correctly.
- Display dates relative to "now".
- Pluralize labels in strings.
- Support for 200+ languages.
- Runs in the browser and Node.js.
- Built on standards.

### Example

There are many examples [on the website][Handlebars Intl], but here's a comprehensive one:

```handlebars
{{formatMessage (intlGet "messages.post.meta")
    num=post.comments.length
    ago=(formatRelative post.date)}}
```

```js
var context = {
    post: {
        date    : 1422046290531,
        comments: [/*...*/]
    }
};

var intlData = {
    locales : ['en-US'],
    messages: {
        post: {
            meta: 'Posted {ago}, {num, plural, one{# comment} other{# comments}}'
        }
    }
};

var template = Handlebars.compile(/* Template source above */);

var html = template(context, {
    data: {intl: intlData}
});
```

This example would render: **"Posted 3 days ago, 1,000 comments"** to the `html` variable. The `post.meta` message is written in the industry standard [ICU Message syntax][], which you can also learn about on the [FormatJS website][FormatJS].


Contribute
----------

Let's make Handlebars Intl and FormatJS better! If you're interested in helping, all contributions are welcome and appreciated. Handlebars Intl is just one of many packages that make up the [FormatJS suite of packages][FormatJS GitHub], and you can contribute to any/all of them, including the [Format JS website][FormatJS] itself.

Check out the [Contributing document][CONTRIBUTING] for the details. Thanks!


License
-------

This software is free to use under the Yahoo! Inc. BSD license.
See the [LICENSE file][LICENSE] for license text and copyright information.


[Handlebars Intl]: http://formatjs.io/handlebars/
[Handlebars]: http://handlebarsjs.com/
[npm]: https://www.npmjs.org/package/handlebars-intl
[npm-badge]: https://img.shields.io/npm/v/handlebars-intl.svg?style=flat-square
[travis]: https://travis-ci.org/yahoo/handlebars-intl
[travis-badge]: http://img.shields.io/travis/yahoo/handlebars-intl.svg?style=flat-square
[david]: https://david-dm.org/yahoo/handlebars-intl
[david-badge]: https://img.shields.io/david/yahoo/handlebars-intl.svg?style=flat-square
[sauce]: https://saucelabs.com/u/handlebars-intl
[sauce-badge]: https://saucelabs.com/browser-matrix/handlebars-intl.svg
[FormatJS]: http://formatjs.io/
[FormatJS GitHub]: http://formatjs.io/github/
[ICU Message syntax]: http://formatjs.io/guide/#messageformat-syntax
[CONTRIBUTING]: https://github.com/yahoo/handlebars-intl/blob/master/CONTRIBUTING.md
[LICENSE]: https://github.com/yahoo/handlebars-intl/blob/master/LICENSE

---
_Source: https://npm.io/package/handlebars-intl · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._