respect-validation/library/Rules/Time.php
Henrique Moody fb2ebaf5d6
Apply contribution guidelines to "DateTime" rule
This commit also makes some changes in how the `DateTime` rule behaves,
by not accepting `DateTimeInterface` as valid when a format is given.

Also:
- Create `DateTimeHelper` to eliminate some code duplication;
- Create integration tests for `DateTime` rule;
- Rename "format" placeholder to "sample" in the message;
- Update documentation of "DateTime" rule.
2018-01-30 20:17:10 +01:00

65 lines
1.3 KiB
PHP

<?php
/*
* This file is part of Respect/Validation.
*
* (c) Alexandre Gomes Gaigalas <alexandre@gaigalas.net>
*
* For the full copyright and license information, please view the "LICENSE.md"
* file that was distributed with this source code.
*/
declare(strict_types=1);
namespace Respect\Validation\Rules;
use function date_parse_from_format;
use function is_scalar;
use function preg_match;
use function sprintf;
use Respect\Validation\Helpers\DateTimeHelper;
use Respect\Validation\Exceptions\ComponentException;
/**
* Validates whether an input is a time or not
*
* @author Henrique Moody <henriquemoody@gmail.com>
*/
final class Time extends AbstractRule
{
use DateTimeHelper;
/**
* @var string
*/
private $format;
/**
* Initializes the rule.
*
* @param string $format
*
* @throws ComponentException
*/
public function __construct(string $format = 'H:i:s')
{
if (!preg_match('/^[gGhHisuvaA\W]+$/', $format)) {
throw new ComponentException(sprintf('"%s" is not a valid date format', $format));
}
$this->format = $format;
}
/**
* {@inheritdoc}
*/
public function validate($input): bool
{
if (!is_scalar($input)) {
return false;
}
return $this->isDateTime($this->format, (string) $input);
}
}