Class: Parse::Constraint::BetweenConstraint

Inherits:
Constraint
  • Object
show all
Defined in:
lib/parse/query/constraints.rb

Overview

A general range constraint that combines greater-than-or-equal and less-than-or-equal constraints for numeric, date/time, and string range queries. This is equivalent to using both $gte and $lte. This constraint works with numbers, dates, times, strings (alphabetical), and any comparable values.

Find products with price between 10 and 50

Product.where(:price.between => [10, 50])

Generates: "price": { "$gte": 10, "$lte": 50 }

Find events between two dates

Event.where(:created_at.between => [start_date, end_date])

Generates: "created_at": { "$gte": start_date, "$lte": end_date }

Find users with age between 18 and 65

User.where(:age.between => [18, 65])

Generates: "age": { "$gte": 18, "$lte": 65 }

Find users with names alphabetically between "Alice" and "John"

User.where(:name.between => ["Alice", "John"])

Generates: "name": { "$gte": "Alice", "$lte": "John" }

Instance Method Summary collapse

Instance Method Details

#between ⇒ BetweenConstraint

A registered method on a symbol to create the constraint.

Examples:

q.where :field.between => [min_value, max_value]

Returns:



2458
 
# File 'lib/parse/query/constraints.rb', line 2458

register :between

#build ⇒ Hash

Returns the compiled constraint.

Returns:

  • (Hash) —

    the compiled constraint.



2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
 
# File 'lib/parse/query/constraints.rb', line 2461

def build
  value = formatted_value
  unless value.is_a?(Array) && value.length == 2
    raise ArgumentError, "#{self.class}: Value must be an array with exactly 2 elements [min_value, max_value]"
  end

  min_value, max_value = value

  # Format the values using Parse's formatting (handles dates, numbers, etc.)
  formatted_min = Parse::Constraint.formatted_value(min_value)
  formatted_max = Parse::Constraint.formatted_value(max_value)

  { @operation.operand => {
    Parse::Constraint::GreaterThanOrEqualConstraint.key => formatted_min,
    Parse::Constraint::LessThanOrEqualConstraint.key => formatted_max,
  } }
end