respect-validation/docs/rules/Date.md
Henrique Moody 48405271c5
Replace placeholder "name" with "subject"
The `{{name}}` placeholder could represent different things depending on
the state of the Result, and referring to it as `{{name}}` seems
arbitrary. This commit changes it to `{{subject}}`, which is much more
generic and it describes well what that placeholder can mean.
2025-12-26 21:30:01 +01:00

2.7 KiB

Date

  • Date()
  • Date(string $format)

Validates if input is a date. The $format argument should be in accordance to PHP's date() function, but only those are allowed:

Format Description Values
d Day of the month, 2 digits with leading zeros 01 to 31
j Day of the month without leading zeros 1 to 31
S English ordinal suffix for the day of the month, 2 characters st, nd, rd or th
F A full textual representation of a month, such as January or March January to December
m Numeric representation of a month, with leading zeros 01 to 12
M A short textual representation of a month, three letters Jan to Dec
n Numeric representation of a month, without leading zeros 1 to 12
Y A full numeric representation of a year, 4 digits Examples: 1988 or 2017
y A two digit representation of a year Examples: 88 or 17

When a $format is not given its default value is Y-m-d.

v::date()->isValid('2017-12-31'); // true
v::date()->isValid('2020-02-29'); // true
v::date()->isValid('2019-02-29'); // false
v::date('m/d/y')->isValid('12/31/17'); // true
v::date('F jS, Y')->isValid('May 1st, 2017'); // true
v::date('Ydm')->isValid(20173112); // true

Templates

Date::TEMPLATE_STANDARD

Mode Template
default {{subject}} must be a valid date in the format {{sample}}
inverted {{subject}} must not be a valid date in the format {{sample}}

Template placeholders

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

Categorization

  • Date and Time

Changelog

Version Description
2.0.0 Changed to only validate dates
0.3.9 Created as Date

See also: