instance method
validates_numericality_of
Ruby on Rails 6.1.7.10
Since v3.0.20Signature
validates_numericality_of(*attr_names)
Validates whether the value of the specified attribute is numeric by trying to convert it to a float with Kernel.Float (if only_integer is false) or applying it to the regular expression /\A[+\-]?\d+\z/ (if only_integer is set to true). Precision of Kernel.Float values are guaranteed up to 15 digits.
class Person < ActiveRecord::Base validates_numericality_of :value, on: :create end
Configuration options:
-
:message- A custom error message (default is: “is not a number”). -
:only_integer- Specifies whether the value has to be an integer, e.g. an integral value (default isfalse). -
:allow_nil- Skip validation if attribute isnil(default isfalse). Notice that for Integer and Float columns empty strings are converted tonil. -
:greater_than- Specifies the value must be greater than the supplied value. -
:greater_than_or_equal_to- Specifies the value must be greater than or equal the supplied value. -
:equal_to- Specifies the value must be equal to the supplied value. -
:less_than- Specifies the value must be less than the supplied value. -
:less_than_or_equal_to- Specifies the value must be less than or equal the supplied value. -
:other_than- Specifies the value must be other than the supplied value. -
:odd- Specifies the value must be an odd number. -
:even- Specifies the value must be an even number.
There is also a list of default options supported by every validator: :if, :unless, :on, :allow_nil, :allow_blank, and :strict . See ActiveModel::Validations#validates for more information
The following checks can also be supplied with a proc or a symbol which corresponds to a method:
-
:greater_than -
:greater_than_or_equal_to -
:equal_to -
:less_than -
:less_than_or_equal_to -
:only_integer -
:other_than
For example:
class Person < ActiveRecord::Base validates_numericality_of :width, less_than: ->(person) { person.height } validates_numericality_of :width, greater_than: :minimum_weight end
Parameters
-
attr_namesrest
Source
# File activemodel/lib/active_model/validations/numericality.rb, line 198
def validates_numericality_of(*attr_names)
validates_with NumericalityValidator, _merge_attributes(attr_names)
end
Defined in activemodel/lib/active_model/validations/numericality.rb line 198
· View on GitHub
· Improve this page
· Find usages on GitHub
Defined in ActiveModel::Validations::HelperMethods