123456789_123456789_123456789_123456789_123456789_

Module: ActiveSupport::RangeWithFormat

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Prepended In:
Defined in: activesupport/lib/active_support/core_ext/range/conversions.rb

Overview

Range With Format

Constant Summary

Instance Method Summary

Instance Method Details

#to_formatted_s(format = :default)

Alias for #to_fs.

[ GitHub ]

  
# File 'activesupport/lib/active_support/core_ext/range/conversions.rb', line 58

alias_method :to_formatted_s, :to_fs

#to_fs(format = :default) Also known as: #to_formatted_s

Convert range to a formatted string. See RANGE_FORMATS for predefined formats.

This method is aliased to #to_formatted_s.

range = (1..100)           # => 1..100

range.to_s                 # => "1..100"
range.to_fs(:db)           # => "BETWEEN '1' AND '100'"

range = (1..)              # => 1..
range.to_fs(:db)           # => ">= '1'"

range = (..100)            # => ..100
range.to_fs(:db)           # => "<= '100'"

Adding your own range formats to to_fs

You can add your own formats to the Range::RANGE_FORMATS hash. Use the format name as the hash key and a Proc instance.

# config/initializers/range_formats.rb
Range::RANGE_FORMATS[:short] = ->(start, stop) { "Between #{start.to_fs(:db)} and #{stop.to_fs(:db)}" }
[ GitHub ]

  
# File 'activesupport/lib/active_support/core_ext/range/conversions.rb', line 51

def to_fs(format = :default)
  if formatter = RANGE_FORMATS[format]
    formatter.call(self.begin, self.end)
  else
    to_s
  end
end