Giter Club home page Giter Club logo

react-intl's Introduction

Internationalize React apps declaratively. This library provides React components and an API to format dates, numbers, and string messages, including pluralization.

npm Version Build Status Dependency Status


An overview and discussion of React Intl v2 can be found in #162

React Intl is part of FormatJS, the v1 docs can be found on the website:


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


There are many examples on the website, but here's a hello world one:

import React, {Component} from 'react';
import ReactDOM from 'react-dom';
import {IntlProvider, FormattedNumber, FormattedPlural} from 'react-intl';

class App extends Component {
    constructor(props) {
        this.state = {
            name       : 'Eric',
            unreadCount: 1000,

    render() {
        const {name, unreadCount} = this.state;

        return (
                Hello <b>{name}</b>, you have {' '}
                <FormattedNumber value={unreadCount} /> {' '}
                <FormattedPlural value={unreadCount}

    <IntlProvider locale="en">
        <App />

This example would render: "Hello Eric, you have 1,000 messages." into the container element on the page.

CLDR pluralization rules: In some languages you have more then one and other. For example in ru there are the following plural rules: one, few, many and other. Check out the official CLDR documentation from for all languages.

Note: You could also write =0 { No comments yet }


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

Check out the Contributing document for the details. Thanks!


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

react-intl's People


akx avatar baer avatar caridy avatar ericf avatar jamiebuilds avatar jasonmit avatar jlecomte avatar juandopazo avatar lencioni avatar mattikl avatar mattparrilla avatar okuryu avatar pjvds avatar roderickhsiao avatar rsamec avatar ryan1234 avatar



Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.