EraJa
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
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Note
I think about the era and there is a problem in the following.
- The date in the lunar calendar Although it is September 8, 1868 the start of the Meiji era.
- Start date Taisho, Showa is the same day as the last day of the Meiji, Taisho, respectively.
Author
tomi [email protected]
License
MIT License. For more imformation, please see LICENSE.