0 follower

Final Class Yiisoft\Validator\Rule\Date\DateTime

All Classes | Methods
InheritanceYiisoft\Validator\Rule\Date\DateTime » Yiisoft\Validator\Rule\Date\BaseDate
ImplementsYiisoft\Validator\RuleInterface, Yiisoft\Validator\SkipOnEmptyInterface, Yiisoft\Validator\SkipOnErrorInterface, Yiisoft\Validator\WhenInterface
Uses TraitsYiisoft\Validator\Rule\Trait\SkipOnEmptyTrait, Yiisoft\Validator\Rule\Trait\SkipOnErrorTrait, Yiisoft\Validator\Rule\Trait\WhenTrait

Defines validation options to check that the value is a date with time.

A simple example of how to use it to validate a date with time:

$rules = [
    'date' => new Yiisoft\Validator\Rule\Date\DateTime(format: 'php:Y-m-d, H:i'),
];

In the example above, the PHP attributes equivalent will be:

use Yiisoft\Validator\Validator;
use Yiisoft\Validator\Rule\Date\DateTime;

final class User
{
    public function __construct(
        #[DateTime(format: 'php:Y-m-d, H:i')]
        public string $date,
    ) }
}

$user = new User(date: '2022-01-01, 23:15');

$validator = (new Validator())->validate($user);

See also Yiisoft\Validator\Rule\Date\DateTimeHandler.

Public Methods

Hide inherited methods

Method Description Defined By
__construct() Yiisoft\Validator\Rule\Date\DateTime
getDateType() Yiisoft\Validator\Rule\Date\DateTime
getFormat() Yiisoft\Validator\Rule\Date\BaseDate
getHandler() Yiisoft\Validator\Rule\Date\DateTime
getIncorrectInputMessage() Yiisoft\Validator\Rule\Date\BaseDate
getLocale() Yiisoft\Validator\Rule\Date\BaseDate
getMax() Yiisoft\Validator\Rule\Date\BaseDate
getMessageDateType() Yiisoft\Validator\Rule\Date\DateTime
getMessageFormat() Yiisoft\Validator\Rule\Date\BaseDate
getMessageTimeType() Yiisoft\Validator\Rule\Date\DateTime
getMin() Yiisoft\Validator\Rule\Date\BaseDate
getName() Yiisoft\Validator\Rule\Date\BaseDate
getSkipOnEmpty() A getter for $skipOnEmpty property. Yiisoft\Validator\Rule\Trait\SkipOnEmptyTrait
getTimeType() Yiisoft\Validator\Rule\Date\DateTime
getTimeZone() Yiisoft\Validator\Rule\Date\BaseDate
getTooEarlyMessage() Yiisoft\Validator\Rule\Date\BaseDate
getTooLateMessage() Yiisoft\Validator\Rule\Date\BaseDate
getWhen() A getter for $when property. Yiisoft\Validator\Rule\Trait\WhenTrait
shouldSkipOnError() A getter for $skipOnError property. Yiisoft\Validator\Rule\Trait\SkipOnErrorTrait
skipOnEmpty() An immutable setter to change $skipOnEmpty property. Yiisoft\Validator\Rule\Trait\SkipOnEmptyTrait
skipOnError() An immutable setter to change $skipOnError property. Yiisoft\Validator\Rule\Trait\SkipOnErrorTrait
when() An immutable setter to change $when property. Yiisoft\Validator\Rule\Trait\WhenTrait

Method Details

Hide inherited methods

__construct() public method

public __construct( string|null $format = null, integer|null $dateType = null, integer|null $timeType = null, string|null $timeZone = null, string|null $locale = null, DateTimeInterface|integer|string|null $min = null, DateTimeInterface|integer|string|null $max = null, string|null $messageFormat = null, integer|null $messageDateType = null, integer|null $messageTimeType = null, string|null $incorrectInputMessage = null, string|null $tooEarlyMessage = null, string|null $tooLateMessage = null, mixed|null $skipOnEmpty = null, boolean $skipOnError = false, Closure|null $when = null ): mixed
$format string|null

The date format that the value being validated should follow. This can be a date pattern as described in the ICU manual.

Alternatively this can be a string prefixed with php: representing a format that can be recognized by the PHP Datetime class. Please refer to https://www.php.net/manual/datetimeimmutable.createfromformat.php on supported formats.

Here are some example values:

'MM/dd/yyyy, HH:mm' // date in ICU format
'php:m/d/Y, H:i' // the same date in PHP format
$dateType integer|null

Format of the date determined by one of the IntlDateFormatter constants. It is used when $format is not set.
$timeType integer|null

Format of the time determined by one of the IntlDateFormatter constants. It is used when $format is not set.
$timeZone string|null

The timezone to use for parsing and formatting date values. This can be any value that may be passed to date_default_timezone_set()> e.g. UTC, Europe/Berlin or America/Chicago. Refer to the php manual for available timezones.
$locale string|null

Locale to use when formatting or parsing or null to use the value specified in the ini setting intl.default_locale.
$min DateTimeInterface|integer|string|null

Lower limit of the date. Defaults to null, meaning no lower limit. This can be a unix timestamp or a string representing a date value or DateTimeInterface instance.
$max DateTimeInterface|integer|string|null

Upper limit of the date. Defaults to null, meaning no upper limit. This can be a unix timestamp or a string representing a date value or DateTimeInterface instance.
$messageFormat string|null

Date format that is used in error messages.
$messageDateType integer|null

One of the IntlDateFormatter constants that used determines date format for error messages used when $messageFormat is not set.
$messageTimeType integer|null

One of the IntlDateFormatter constants that used determines time format for error messages used when $messageFormat is not set.
$incorrectInputMessage string|null

A message used when the validated value is not valid date. You may use the following placeholders in the message:

  • {property}: the translated label of the property being validated.
$tooEarlyMessage string|null

A message used when the validated date is less than $min. You may use the following placeholders in the message:

  • {property}: the translated label of the property being validated.
  • {value}: the validated date.
  • {limit}: expected minimum date.
$tooLateMessage string|null

A message used when the validated date is more than $max. You may use the following placeholders in the message:

  • {property}: the translated label of the property being validated.
  • {value}: the validated date.
  • {limit}: expected maximum date.
$skipOnEmpty mixed|null

Whether to skip this rule if the value validated is empty. See Yiisoft\Validator\SkipOnEmptyInterface.
$skipOnError boolean

Whether to skip this rule if any of the previous rules gave an error. See \Yiisoft\Validator\Rule\Date\SkipOnErrorInterface.
$when Closure|null

A callable to define a condition for applying the rule. See Yiisoft\Validator\WhenInterface.

 

                public function __construct(
    ?string $format = null,
    private readonly ?int $dateType = null,
    private readonly ?int $timeType = null,
    ?string $timeZone = null,
    ?string $locale = null,
    int|string|DateTimeInterface|null $min = null,
    int|string|DateTimeInterface|null $max = null,
    ?string $messageFormat = null,
    private readonly ?int $messageDateType = null,
    private readonly ?int $messageTimeType = null,
    ?string $incorrectInputMessage = null,
    ?string $tooEarlyMessage = null,
    ?string $tooLateMessage = null,
    bool|callable|null $skipOnEmpty = null,
    bool $skipOnError = false,
    ?Closure $when = null,
) {
    parent::__construct(
        $format,
        $timeZone,
        $locale,
        $min,
        $max,
        $messageFormat,
        $incorrectInputMessage,
        $tooEarlyMessage,
        $tooLateMessage,
        $skipOnEmpty,
        $skipOnError,
        $when,
    );
}
getDateType() public method

public getDateType( ): integer|null

                public function getDateType(): ?int
{
    return $this->dateType;
}
getFormat() public method

Defined in: Yiisoft\Validator\Rule\Date\BaseDate::getFormat()

public getFormat( ): string|null

                public function getFormat(): ?string
{
    return $this->format;
}
getHandler() public method

public getHandler( ): string

                public function getHandler(): string
{
    return DateTimeHandler::class;
}
getIncorrectInputMessage() public method

Defined in: Yiisoft\Validator\Rule\Date\BaseDate::getIncorrectInputMessage()

public getIncorrectInputMessage( ): string|null

                public function getIncorrectInputMessage(): ?string
{
    return $this->incorrectInputMessage;
}
getLocale() public method

Defined in: Yiisoft\Validator\Rule\Date\BaseDate::getLocale()

public getLocale( ): string|null

                public function getLocale(): ?string
{
    return $this->locale;
}
getMax() public method

Defined in: Yiisoft\Validator\Rule\Date\BaseDate::getMax()

public getMax( ): DateTimeInterface|integer|string|null

                public function getMax(): DateTimeInterface|int|string|null
{
    return $this->max;
}
getMessageDateType() public method

public getMessageDateType( ): integer|null

                public function getMessageDateType(): ?int
{
    return $this->messageDateType;
}
getMessageFormat() public method

Defined in: Yiisoft\Validator\Rule\Date\BaseDate::getMessageFormat()

public getMessageFormat( ): string|null

                public function getMessageFormat(): ?string
{
    return $this->messageFormat;
}
getMessageTimeType() public method

public getMessageTimeType( ): integer|null

                public function getMessageTimeType(): ?int
{
    return $this->messageTimeType;
}
getMin() public method

Defined in: Yiisoft\Validator\Rule\Date\BaseDate::getMin()

public getMin( ): DateTimeInterface|integer|string|null

                public function getMin(): DateTimeInterface|int|string|null
{
    return $this->min;
}
getName() public method

Defined in: Yiisoft\Validator\Rule\Date\BaseDate::getName()

public getName( ): string

                public function getName(): string
{
    return 'date';
}
getSkipOnEmpty() public method

Defined in: Yiisoft\Validator\Rule\Trait\SkipOnEmptyTrait::getSkipOnEmpty()

A getter for $skipOnEmpty property.

public getSkipOnEmpty( ): boolean|callable|null
return boolean|callable|null

A current raw (non-normalized) value.

 

                public function getSkipOnEmpty(): bool|callable|null
{
    return $this->skipOnEmpty;
}
getTimeType() public method

public getTimeType( ): integer|null

                public function getTimeType(): ?int
{
    return $this->timeType;
}
getTimeZone() public method

Defined in: Yiisoft\Validator\Rule\Date\BaseDate::getTimeZone()

public getTimeZone( ): non-empty-string|null

                public function getTimeZone(): ?string
{
    return $this->timeZone;
}
getTooEarlyMessage() public method

Defined in: Yiisoft\Validator\Rule\Date\BaseDate::getTooEarlyMessage()

public getTooEarlyMessage( ): string|null

                public function getTooEarlyMessage(): ?string
{
    return $this->tooEarlyMessage;
}
getTooLateMessage() public method

Defined in: Yiisoft\Validator\Rule\Date\BaseDate::getTooLateMessage()

public getTooLateMessage( ): string|null

                public function getTooLateMessage(): ?string
{
    return $this->tooLateMessage;
}
getWhen() public method

Defined in: Yiisoft\Validator\Rule\Trait\WhenTrait::getWhen()

A getter for $when property.

public getWhen( ): Closure|null
return Closure|null

Current value:

  • null - always apply the validation.
  • callable - apply the validation depending on a return value: true - apply, false - do not apply.
 

                public function getWhen(): ?Closure
{
    return $this->when;
}
shouldSkipOnError() public method

Defined in: Yiisoft\Validator\Rule\Trait\SkipOnErrorTrait::shouldSkipOnError()

A getter for $skipOnError property.

public shouldSkipOnError( ): boolean
return boolean

Current value. true means to skip the current rule when the previous one errored and false - do not skip.

 

                public function shouldSkipOnError(): bool
{
    return $this->skipOnError;
}
skipOnEmpty() public method

Defined in: Yiisoft\Validator\Rule\Trait\SkipOnEmptyTrait::skipOnEmpty()

An immutable setter to change $skipOnEmpty property.

public skipOnEmpty( boolean|callable|null $value ): $this
$value boolean|callable|null

A new value.
return $this

The new instance with a changed value.

 

                public function skipOnEmpty(bool|callable|null $value): static
{
    $new = clone $this;
    $new->skipOnEmpty = $value;
    return $new;
}
skipOnError() public method

Defined in: Yiisoft\Validator\Rule\Trait\SkipOnErrorTrait::skipOnError()

An immutable setter to change $skipOnError property.

public skipOnError( boolean $value ): $this
$value boolean

A new value. true means to skip the current rule when the previous one errored and false - do not skip.
return $this

The new instance with a changed value.

 

                public function skipOnError(bool $value): static
{
    $new = clone $this;
    $new->skipOnError = $value;
    return $new;
}
when() public method

Defined in: Yiisoft\Validator\Rule\Trait\WhenTrait::when()

An immutable setter to change $when property.

public when( Closure|null $value ): $this
$value Closure|null

A new value:

  • null - always apply the validation.
  • callable - apply the validation depending on a return value: true - apply, false - do not apply.
return $this

The new instance with a changed value.

 

                public function when(?Closure $value): static
{
    $new = clone $this;
    $new->when = $value;
    return $new;
}