t('my.messages.hello')

# same as 'my.messages.hello'
t(:hello, scope: 'my.messages')
t(:hello, scope: [:my, :messages])

t('my.messages.hello', default: "Hello")
en:
  my:
    messages:
      hello: "Hello"

Interpolation

t('hello', name: "John")
hello: "Hello %{name}"

Lazy lookup

# from the 'books/index' view
t('.title')
en:
  books:
    index:
      title: "Título"

Plural

t(:inbox, count: 1)  #=> 'one message'
t(:inbox, count: 2)  #=> '2 messages'
inbox:
  one: 'one message',
  other: '%{count} messages'

Localizing

Time

l(Time.now)
l(Time.now, format: :short)
en:
  time:
    formats:
      default: "%a, %d %b %Y %H:%M:%S %z"
      long: "%B %d, %Y %H:%M"
      short: "%d %b %H:%M"

Date

l(Date.today)
en:
  date:
    formats:
      default: "%Y-%m-%d" # 2015-06-25
      long: "%B %d, %Y"   # June 25, 2015
      short: "%b %d"      # Jun 25

ActiveRecord

Model names

User.model_name.human            #=> "User"
Child.model_name.human(count: 2) #=> "Children"
en:
  activerecord:
    models:
      user: "User"
      child:
        one: "Child"
        other: "Children"

Attributes

User.human_attribute_for :name   #=> "Name"
en:
  activerecord:
    attributes:
      user:
        # activerecord.attributes.<model>.<field>
        name: "Name"
        email: "Email"

Error messages

error_messages_for(...)
activerecord:
  errors:
    models:
      venue:
        attributes:
          name:
            blank: "Please enter a name."

Possible scopes (in order):

activerecord.errors.models.[model_name].attributes.[attribute_name].[error]
activerecord.errors.models.[model_name].[error]
activerecord.errors.messages.[error]
errors.attributes.[attribute_name].[error]
errors.messages.[error]

Where [error] can be:

validates
  confirmation - :confirmation
  acceptance   - :accepted
  presence     - :blank
  length       - :too_short (%{count})
  length       - :too_long (%{count})
  length       - :wrong_length (%{count})
  uniqueness   - :taken
  format       - :invalid
  numericality - :not_a_number

Form labels

form_for @post do
  f.label :body
helpers:
  # helpers.label.<model>.<field>
  label:
    post:
      body: "Your body text"

Submit buttons

form_for @post do
  f.submit
helpers:
  submit:
    # helpers.submit.<action>
    create: "Create a %{model}"
    update: "Confirm changes to %{model}"

    # helpers.submit.<model>.<action>
    article:
      create: "Publish article"
      update: "Update article"

Numbers

number_to_delimited(2000)             #=> "2,000"
number_to_currency(12.3)              #=> "$12.30"
number_to_percentage(0.3)             #=> "30%"
number_to_rounded(3.14, precision: 0) #=> "3"
number_to_human(12_000)               #=> "12 Thousand"
number_to_human_size(12345)           #=> "12.3 kb"

Delimited

number_to_delimited(n)
number:
  format:
    separator: '.'
    delimiter: ','
    precision: 3
    significant: false
    strip_insignificant_zeroes: false

Currencies

number_to_currency(n)
number:
  currency:
    format:
      format: "%u%n" # %u = unit, %n = number
      unit: "$"
      separator: '.'
      delimiter: ','
      precision: 3
      # (see number.format)

Percentage

number_to_percentage(n)
number:
  percentage:
    format:
      format: "%n%"
      # (see number.format)

Programmatic access

I18n.backend.store_translations :en, ok: "Ok"
I18n.locale = :en
I18n.default_locale = :en

I18n.available_locales

I18n.translate :ok   # aka, I18n.t
I18n.localize date   # aka, I18n.l

Reference

  • http://guides.rubyonrails.org/i18n.html
  • http://rails-i18n.org/wiki
  • https://github.com/svenfuchs/i18n
  • https://github.com/svenfuchs/rails-i18n/blob/master/rails/locale/en.yml