number_to_yen

number_to_yen

数値を日本円の表記（例: 12万3,456円）の文字列にフォーマットする helper です。 Active Support の number_to_currency に強く影響を受けています。

$ gem install number_to_yen

require 'number_to_yen'
include NumberToYen

number_to_yen(1234)       # => "1,234円"
number_to_yen(123456)     # => "12万3,456円"
number_to_yen(123456.0)   # => "12万3,456円"
number_to_yen(1234567890) # => "12億3,456万7,890円"

4 桁区切りで 0 が 4 つ続く場合、日本語の慣習に倣ってそれらの桁は省略されます。

number_to_yen(120000)     # => "12万円"
number_to_yen(1234560000) # => "12億3,456万円"
number_to_yen(1200007890) # => "12億7,890円" 
number_to_yen(1200000000) # => "12億円" 

Ruby on Rails の場合

Gemfile に

gem 'number_to_yen'

を追記して bundle install してください。include などは不要です。View の helper に number_to_yen が追加されます。

<%= number_to_yen(123456) %> # => "12万3,456円"

コア拡張を使う場合

Gemfile に次のように指定すると、Integer や Float にインスタンスメソッド to_yen が生えます。

gem 'number_to_yen', require: 'number_to_yen/core_ext'

1234.to_yen       # => "1,234円"
123456.to_yen     # => "12万3,456円"
123456.0.to_yen   # => "12万3,456円"
1234567890.to_yen # => "12億3,456万7,890円"

より簡潔に書けて便利ですが、helper の number_to_yen とコア拡張の to_yen どちらを使うかは個別に判断してください。

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ttanimichi/number_to_yen

License

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