Formatters
Friendly data formatting for your Rails views.
Time.now.format_as :nice_date_time # => "January 8th, 2017 at 11:45"
Installation
Add this line to your application's Gemfile:
gem 'formatters'
And then execute:
$ bundle
Or install it yourself as:
$ gem install formatters
Usage
Create a formatters.rb in your config/initializers directory and add some formats as blocks. make a call to config.define_format with a symbol for the name of the format as an argument. The block code returns the formatted value.
Formatters.setup do |config|
config.define_format :amount do |value|
"%.2f" % value.round(2)
end
config.define_format :money do |value|
if value.to_f >= 0
"$#{value.format_as(:amount)}"
else
"-$#{value.abs.format_as(:amount)}"
end
end
config.define_format :invoice_number do |value|
value.to_s.rjust(5, '0')
end
config.define_format :nice_date_time do |value|
if value.kind_of? DateTime
value.strftime("%B #{value.day.ordinalize}, %Y at %H:%M")
elsif value.kind_of? Time
value.strftime("%B #{value.day.ordinalize}, %Y at %H:%M")
else
value
end
end
config.define_format :yes_no do |value|
I18n.t((!!value).to_s)
end
end
To use a format in a view, or anywhere else that requires a common approach to displaying formatted data (emailers, etc), simply call the format_as method on your data object and pass the name of your defined format as a symbol.
true.format_as :yes_no # => "Yes"
899.99.format_as :money # => "$899.99"
Time.now.format_as :nice_date_time # => "January 8th, 2017 at 11:45"
You can chain formatters and build more complex formats from simple formats such as
config.define_format :amount do |value|
"%.2f" % value.round(2)
end
config.define_format :money do |value|
if value.to_f >= 0
"$#{value.format_as(:amount)}"
else
"-$#{value.abs.format_as(:amount)}"
end
end
Contributing
- Fork it ( https://github.com/[my-github-username]/rails_default_value/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request