Module: ActiveSupport::RangeWithFormat

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

Constant Summary

RANGE_FORMATS =
# File 'activesupport/lib/active_support/core_ext/range/conversions.rb', line 4

{
  db: -> (start, stop) do
    case start
    when String then "BETWEEN '#{start}' AND '#{stop}'"
    else
      "BETWEEN '#{start.to_s(:db)}' AND '#{stop.to_s(:db)}'"
    end
  end
}

Instance Method Summary

#to_default_s(format = :default)

Alias for #to_s.
#to_formatted_s(format = :default)

Alias for #to_s.
#to_s(format = :default) (also: #to_default_s, #to_formatted_s)

Convert range to a formatted string.

Instance Method Details

#to_default_s(format = :default)

Alias for #to_s.

[ GitHub ]

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


alias_method :to_default_s, :to_s

#to_formatted_s(format = :default)

Alias for #to_s.

[ GitHub ]

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


alias_method :to_formatted_s, :to_s

#to_s(format = :default) Also known as: #to_default_s, #to_formatted_s

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

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

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

Adding your own range formats to to_s

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_s(:db)} and #{stop.to_s(:db)}" }

[ GitHub ]

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


def to_s(format = :default)
  if formatter = RANGE_FORMATS[format]
    formatter.call(first, last)
  else
    super()
  end
end