Neos\Flow\Validation\Validator\DateTimeRangeValidator::isValid PHP Method

DateTimeRangeValidator Class Documentation Show file Open project: neos/flow-development-collection

isValid() protected method

latestDate and earliestDate may be each , / or /, where is an ISO 8601 duration and or or may be 'now' or a PHP supported format. (1) In general, you are able to provide a timestamp or a timestamp with additional calculation. Calculations are done as described in ISO 8601 (2), with an introducing "P". P7MT2H30M for example mean a period of 7 months, 2 hours and 30 minutes (P introduces a period at all, while a following T introduces the time-section of a period. This is not at least in order not to confuse months and minutes, both represented as M). A period is separated from the timestamp with a forward slash "/". If the period follows the timestamp, that period is added to the timestamp; if the period precedes the timestamp, it's subtracted. The timestamp can be one of PHP's supported date formats (1), so also "now" is supported. Use cases: If you offer something that has to be manufactured and you ask for a delivery date, you might assure that this date is at least two weeks in advance; this could be done with the expression "now/P2W". If you have a library of ancient goods and want to track a production date that is at least 5 years ago, you can express it with "P5Y/now". Examples: If you want to test if a given date is at least five minutes ahead, use earliestDate: now/PT5M If you want to test if a given date was at least 10 days ago, use latestDate: P10D/now If you want to test if a given date is between two fix boundaries, just combine the latestDate and earliestDate-options: earliestDate: 2007-03-01T13:00:00Z latestDate: 2007-03-30T13:00:00Z Footnotes: http://de.php.net/manual/en/datetime.formats.compound.php (1) http://en.wikipedia.org/wiki/ISO_8601#Durations (2) http://en.wikipedia.org/wiki/ISO_8601#Time_intervals (3)

protected isValid ( mixed $dateTime ) : void
$dateTime	mixed	The DateTime value that should be validated
return	void

    protected function isValid($dateTime)
    {
        if (!$dateTime instanceof \DateTimeInterface) {
            $this->addError('The given value was not a valid date', 1324314378);
            return;
        }
        $earliestDate = isset($this->options['earliestDate']) ? $this->parseReferenceDate($this->options['earliestDate']) : null;
        $latestDate = isset($this->options['latestDate']) ? $this->parseReferenceDate($this->options['latestDate']) : null;
        if (isset($earliestDate) && isset($latestDate)) {
            if ($dateTime < $earliestDate || $dateTime > $latestDate) {
                $this->addError('The given date must be between %s and %s', 1325615630, [$earliestDate->format('Y-m-d H:i:s'), $latestDate->format('Y-m-d H:i:s')]);
            }
        } elseif (isset($earliestDate)) {
            if ($dateTime < $earliestDate) {
                $this->addError('The given date must be after %s', 1324315107, [$earliestDate->format('Y-m-d H:i:s')]);
            }
        } elseif (isset($latestDate)) {
            if ($dateTime > $latestDate) {
                $this->addError('The given date must be before %s', 1324315115, [$latestDate->format('Y-m-d H:i:s')]);
            }
        }
    }

DateTimeRangeValidator

isValid

parseReferenceDate