respect-validation/docs/validators/Time.md

Time

• Time()
• Time(string $format)

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

Format	Description	Values
g	12-hour format of an hour without leading zeros	1 through 12
G	24-hour format of an hour without leading zeros	0 through 23
h	12-hour format of an hour with leading zeros	01 through 12
H	24-hour format of an hour with leading zeros	00 through 23
i	Minutes with leading zeros	00 to 59
s	Seconds, with leading zeros	00 through 59
u	Microseconds	000000 through 999999
v	Milliseconds	000 through 999
a	Lowercase Ante meridiem and Post meridiem	am or pm
A	Uppercase Ante meridiem and Post meridiem	AM or PM

When a $format is not given its default value is H:i:s.

v::time()->isValid('00:00:00'); // true
v::time()->isValid('23:20:59'); // true
v::time('H:i')->isValid('23:59'); // true
v::time('g:i A')->isValid('8:13 AM'); // true
v::time('His')->isValid(232059); // true

v::time()->isValid('24:00:00'); // false
v::time()->isValid(new DateTime()); // false
v::time()->isValid(new DateTimeImmutable()); // false

Templates

Time::TEMPLATE_STANDARD

Mode	Template
default	{{subject}} must be a valid time in the format {{sample}}
inverted	{{subject}} must not be a valid time 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	Created

---

See also:

• Date
• DateTime
• DateTimeDiff
• LeapDate
• LeapYear