# 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()](http://php.net/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`.

```php
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`  | {{name}} must be a valid time in the format {{sample}}     |
| `inverted` | {{name}} must not be a valid time in the format {{sample}} |

## Template placeholders

| Placeholder | Description                                                      |
|-------------|------------------------------------------------------------------|
| `name`      | 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](Date.md)
- [DateTime](DateTime.md)
- [DateTimeDiff](DateTimeDiff.md)
- [LeapDate](LeapDate.md)
- [LeapYear](LeapYear.md)