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.

EraJa#to_era of extra format string is follow.

  • %o: era(alphabet)
  • %O: era(kanzi)
  • %E: era year
  • %J: kanzi number

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日") # => "平成二十四年四月二十九日"

Change number to kansuuzi

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

Era names

If you want to convert custom ara string, 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 new Pull Request

Note

I think about the era and there is a problem in the following.

Author

tomi [email protected]

License

MIT License. For more imformation, please see LICENSE.