/era_ja

Convert to Japanese era

Primary LanguageRubyMIT LicenseMIT

EraJa Build Status

Convert to Japanese era.

Installation

Add this line to your application's Gemfile:

gem 'era_ja'

And then execute:

$ bundle

Or install it yourself as:

$ gem install era_ja

ruby version

See .travis.yml

NOTE :: era_ja does not support ruby 1.9.3 since 0.4.0

Usage

format string

strftime format string can be used as an argument.

Extra format strings provided by EraJa#to_era are:

  • %o: era(alphabet)
  • %O: era(kanzi)
  • %1O: era(single kanzi)
  • %E: era year
  • %J: kanzi numeral

Time instance to Japanese era

require 'era_ja'
Time.mktime(2012,4,29).to_era   # => "H24.4.29"
Time.mktime(2012,4,29).to_era("%O%E年%m月%d日") # => "平成24年4月29日"
Time.mktime(2012,4,29).to_era("%O%JE年%Jm月%Jd日") # => "平成二十四年四月二十九日"

Date instance to Japanese era

require 'era_ja'
Date.new(2012,4,29).to_era     # => "H24.4.29"
Date.new(2012,4,29).to_era("%O%E年%m月%d日") # => "平成24年4月29日"
Date.new(2012,4,29).to_era("%O%JE年%Jm月%Jd日") # => "平成二十四年四月二十九日"

Convert numerals to kanzi

Time.mktime(2012,4,29).to_era("%Jy年%Jm月%Jd日") # => "二千十二年四月二十九日"
Date.new(2012,4,29).to_era("%Jy年%Jm月%Jd日")    # => "二千十二年四月二十九日"

Era names

To convert to single kanji era strings, you can use %1O.

require 'era_ja'
Time.mktime(2012,4,29).to_era("%1O%E年%m月%d日") # => "平24年4月29日"

To convert to custom era strings, you can set era_names .

require 'era_ja'
Time.mktime(2012,4,29).to_era(era_names: { heisei: ['h', '平'] })                       # => "h24.4.29"
Time.mktime(2012,4,29).to_era("%O%E年%m月%d日", era_names: { heisei: ['h', '平'] })     # => "平24年4月29日"
Time.mktime(2012,4,29).to_era("%O%JE年%Jm月%Jd日", era_names: { heisei: ['h', '平'] })  # => "平二十四年四月二十九日"
# same as Date

Support

Report issues and feature requests to github Issues. https://github.com/tomiacannondale/era_ja/issues

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Note

The following issues exist regarding era:

Author

tomi tomiacannondale@gmail.com

License

MIT License. For more information, please see LICENSE.