respect-validation/docs/validators/Decimal.md
Alexandre Gomes Gaigalas 16148e9593 Standardize and improve validation message templates
- Remove redundant "valid" prefix:
   Date, DateTime, DateTimeDiff, Domain, Email, Iban, Imei, Ip, Isbn, Json, LanguageCode, LeapDate, LeapYear, Luhn, MacAddress, NfeAccessKey, Nif, Nip, Pesel, Phone, Pis, PolishIdCard, PostalCode, Roman, Slug, Tld, Url, Uuid, Version.

 - Remove redundant "value" suffix
   ArrayVal, BoolVal, Countable, FloatVal, IntVal, IterableVal, NumericVal, ScalarVal, StringVal.

 - Standardize "consist only of" phrasing
   Alnum, Alpha, Cntrl, Consonant, Digit, Graph, Lowercase, Printable, Punct, Space, Spaced, Uppercase, Vowel, Xdigit.

 - Improve file accessibility messages
   Directory, Executable, File, Image, Readable, SymbolicLink, Writable.

 - Improve grammar and article usage
   CreditCard, Extension, Mimetype, Regex, Size.
2026-02-03 19:58:55 +00:00

2.2 KiB

Decimal

  • Decimal(int $decimals)

Validates whether the input matches the expected number of decimals.

v::decimal(2)->assert('27990.50');
// Validation passes successfully

v::decimal(1)->assert('27990.50');
// → "27990.50" must have 1 decimal places

v::decimal(1)->assert(1.5);
// Validation passes successfully

Known limitations

When validating float types, it is not possible to determine the amount of ending zeros and because of that, validations like the ones below will pass.

v::decimal(1)->assert(1.50);
// Validation passes successfully

Templates

Decimal::TEMPLATE_STANDARD

Mode Template
default {{subject}} must have {{decimals}} decimal places
inverted {{subject}} must not have {{decimals}} decimal places

Template placeholders

Placeholder Description
decimals
subject The validated input or the custom validator name (if specified).

Categorization

  • Numbers

Changelog

Version Description
3.0.0 Templates changed
2.2.4 Float values with trailing zeroes are now valid
2.0.0 Created

See Also