ruby-i18n-months

You may use this gem with rails-i18n (although, it's not required).

To install, add to your Gemfile:

gem 'ruby-i18n-months'

This gem add directives %O and %o for month names that are useful in such formats:

Compare with these results (using existing directives %B and %b in Ruby and gem rails-i18n):

The languages listed below use different words for dates in long format(day, month, year: %d %B %Y) and for month and year only (month, year: %O %Y):

• Belorussian
• Greek
• Polish
• Russian
• Ukrainian

This gem adds directives %O and %o in I18n::Backend::Base (used internally in gem ruby-i18n), and adds month names for all languages listed above for these directives.

For Slavic languages these month names are in nominative case, and gem rails-i18n provides month names in genitive case (for directives %B and %b).

Other languages & locales will fallback these directives to %B and %b respectively. In this case you should have gem rails-i18n installed.

You may use localize method (shorted to l), as usual:

I18n.l(Time.new(2022, 3, 1), locale: :ru, format: '%O %Y')
# => "Март 2022" (provided by this gem, `ruby-i18n-months`)

I18n.l(Time.new(2022, 3, 1), locale: :ru, format: '%-e %B %Y')
# => "1 марта 2022" (provided by gem `rails-i18n`)

I18n.l(Time.new(2022, 3, 1), locale: :en, format: '%O %Y')
# => "March 2022" (provided by this gem, `ruby-i18n-months`,
#    with fallback to `%B`, so you need `rails-i18n` also)

I18n.l(Time.new(2022, 3, 1), locale: :en, format: '%-e %B %Y')
# => "1 March 2022" (provided by gem `rails-i18n`)

Using strftime is not supported:

Time.new(2022, 3, 1).strftime('%O %Y')
# => "%O 2022"

To release a new version: bundle exec rake release

Bug reports and pull requests are welcome on GitHub at github.com/crosspath/ruby-i18n-months.

The gem is available as open source under the terms of the MIT License.