respect-validation/docs/validators/Date.md
Alexandre Gomes Gaigalas d9cdc118b2 Introduce REUSE compliance
This commit introduces REUSE compliance by annotating all files
with SPDX information and placing the reused licences in the
LICENSES folder.

We additionally removed the docheader tool which is made obsolete
by this change.

The main LICENSE and copyright text of the project is now not under
my personal name anymore, and it belongs to "The Respect Project
Contributors" instead.

This change restores author names to several files, giving the
appropriate attribution for contributions.
2026-01-21 06:28:11 +00:00

3 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()->assert('2017-12-31');
// Validation passes successfully

v::date()->assert('2020-02-29');
// Validation passes successfully

v::date()->assert('2019-02-29');
// → "2019-02-29" must be a valid date in the format "2005-12-30"

v::date('m/d/y')->assert('12/31/17');
// Validation passes successfully

v::date('F jS, Y')->assert('May 1st, 2017');
// Validation passes successfully

v::date('Ydm')->assert(20173112);
// Validation passes successfully

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: