DominionEnterprises\Filter\DateTime

Complexity

Total Complexity

13

Size/Duplication

Total Lines	59
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	1

Importance

Changes

0

2 Methods

Rating	Name	Duplication	Size	Complexity
B	filter()	0	20	8
A	format()	0	8	3

<?php

namespace TraderInteractive\Filter;

use DateTimeInterface;
use DateTimeZone as DateTimeZoneStandard;
use DateTime as DateTimeStandard;

/**
 * A collection of filters for filtering strings into \DateTime objects.
 */
class DateTime
{
    /**
     * Filters the given value into a \DateTime object.
     *
     * @param mixed                $value     The value to be filtered.
     * @param boolean $allowNull              True to allow nulls through, and false (default) if nulls should
     *                                        not be allowed.
     * @param DateTimeZoneStandard $timezone  A \DateTimeZone object representing the timezone of $value.
     *                                        If $timezone is omitted, the current timezone will be used.
     *
     * @return DateTimeStandard|null
     *
     * @throws Exception if the value did not pass validation.
     */
    public static function filter($value, bool $allowNull = false, DateTimeZoneStandard $timezone = null)
    {
        if ($value === null && $allowNull) {
            return null;
        }

        if ($value instanceof \DateTime) {
            return $value;
        }

        if (is_int($value) || ctype_digit($value)) {
            $value = "@{$value}";
        }

        if (!is_string($value) || trim($value) == '') {
            throw new Exception('$value is not a non-empty string');
        }

        return new \DateTime($value, $timezone);
    }

    /**
     * Filters the give \DateTime object to a formatted string.
     *
     * @param DateTimeInterface $dateTime The date to be formatted.
     * @param string            $format   The format of the outputted date string.
     *
     * @return string
     *
     * @throws \InvalidArgumentException Thrown if $format is not a string
     */
    public static function format(DateTimeInterface $dateTime, string $format = 'c') : string
    {
        if (!is_string($format) || trim($format) === '') {
            throw new \InvalidArgumentException('$format is not a non-empty string');
        }

        return $dateTime->format($format);
    }
}