validates_numericality_of
- 1.0.0
- 1.1.6
- 1.2.6
- 2.0.3
- 2.1.0
- 2.2.1
- 2.3.8
- 3.0.0 (0)
- 3.0.9 (-3)
- 3.1.0 (1)
- 3.2.1 (6)
- 3.2.8 (1)
- 3.2.13 (0)
- 4.0.2 (-28)
- 4.1.8 (1)
- 4.2.1 (1)
- 4.2.7 (0)
- 4.2.9 (0)
- 5.0.0.1 (0)
- 5.1.7 (0)
- 5.2.3 (0)
- 6.0.0 (0)
- 6.1.3.1 (4)
- 6.1.7.7 (0)
- 7.0.0 (1)
- 7.1.3.2 (38)
- 7.1.3.4 (0)
- What's this?
validates_numericality_of(*attr_names)
public
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 (default is false).
-
:only_numeric - Specifies whether the value has to be an instance of Numeric (default is false). The default behavior is to attempt parsing the value if it is a String.
-
:allow_nil - Skip validation if attribute is nil (default is false). Notice that for Integer and Float columns empty strings are converted to nil.
-
:greater_than - Specifies the value must be greater than the supplied value. The default error message for this option is _“must be greater than %{count}”_.
-
:greater_than_or_equal_to - Specifies the value must be greater than or equal the supplied value. The default error message for this option is _“must be greater than or equal to %{count}”_.
-
:equal_to - Specifies the value must be equal to the supplied value. The default error message for this option is _“must be equal to %{count}”_.
-
:less_than - Specifies the value must be less than the supplied value. The default error message for this option is _“must be less than %{count}”_.
-
:less_than_or_equal_to - Specifies the value must be less than or equal the supplied value. The default error message for this option is _“must be less than or equal to %{count}”_.
-
:other_than - Specifies the value must be other than the supplied value. The default error message for this option is _“must be other than %{count}”_.
-
:odd - Specifies the value must be an odd number. The default error message for this option is _“must be odd”_.
-
:even - Specifies the value must be an even number. The default error message for this option is _“must be even”_.
-
:in - Check that the value is within a range. The default error message for this option is _“must be in %{count}”_.
There is also a list of default options supported by every validator: :if, :unless, :on, :allow_nil, :allow_blank, and :strict . See ActiveModel::Validations::ClassMethods#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