SubjectivePHP\Util\DateTime

Complexity

Total Complexity

13

Size/Duplication

Total Lines	115
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	0

Importance

Changes

0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	isWeekendDay()	0	5	1
A	isWeekDay()	0	5	1
A	isSameDay()	0	5	3
A	isDaylightSavings()	0	4	1
A	isInRange()	0	10	3
B	asAgoString()	0	29	4

<?php
namespace SubjectivePHP\Util;

/**
 * Utility class for \DateTime objects.
 */
abstract class DateTime
{
    /**
     * Returns true if the given date time is a Saturday or Sunday.
     *
     * @param \DateTime $dateTime The date/time object.
     *
     * @return boolean
     */
    final public static function isWeekendDay(\DateTime $dateTime)
    {
        //ISO-8601 numeric representation of the day of the week, 1 (for Monday) through 7 (for Sunday)
        return $dateTime->format('N') > 5;
    }

    /**
     * Returns true if the given date time is not a Saturday or Sunday.
     *
     * @param \DateTime $dateTime The date/time object.
     *
     * @return boolean
     */
    final public static function isWeekDay(\DateTime $dateTime)
    {
        //ISO-8601 numeric representation of the day of the week, 1 (for Monday) through 7 (for Sunday)
        return $dateTime->format('N') < 6;
    }

    /**
     * Returns true if the given dates occur on the same year, month and day.
     *
     * @param \DateTime $thisDate A date to compare.
     * @param \DateTime $thatDate A date to compare.
     *
     * @return boolean
     */
    final public static function isSameDay(\DateTime $thisDate, \DateTime $thatDate)
    {
        $interval = $thisDate->diff($thatDate);
        return !$interval->y && !$interval->m && !$interval->d;
    }

    /**
     * Indicates whether the given instance of DateTime is within the daylight saving time range for the current time
     * zone.
     *
     * @param \DateTime $dateTime The date/time object.
     *
     * @return boolean
     */
    final public static function isDaylightSavings(\DateTime $dateTime)
    {
        return (bool)$dateTime->format('I');
    }

    /**
     * Returns true if the given date is between the provided date range.
     *
     * @param \DateTime $subjectDate The date/time object being checked.
     * @param \DateTime $startDate   The start date/time object.
     * @param \DateTime $endDate     The end date/time object.
     *
     * @return boolean
     * @throws \DomainException Thrown when an invalid date range is provided.
     */
    final public static function isInRange(\DateTime $subjectDate, \DateTime $startDate, \DateTime $endDate)
    {
        $subjectTimestamp = $subjectDate->getTimestamp();
        $startDateTimestamp = $startDate->getTimestamp();
        $endDateTimestamp = $endDate->getTimestamp();
        if ($startDateTimestamp > $endDateTimestamp) {
            throw new \DomainException('Invalid date range provided.');
        }
        return ($subjectTimestamp >= $startDateTimestamp && $subjectTimestamp <= $endDateTimestamp);
    }

    /**
     * Returns the given DateTime instance as a "time ago" string.
     *
     * @param \DateTime $dateTime The DateTime object to present as an ago string.
     *
     * @return string
     *
     * @throws \DomainException Thrown if the given $dateTime is in the future.
     */
    final public static function asAgoString(\DateTime $dateTime)
    {
        $numHours = round((time() - $dateTime->getTimestamp())/3600, 2);
        if ($numHours < 0) {
            throw new \DomainException('Cannot create "time ago" string for a date in the future.');
        }

        $formulas = [
            '.025' => ['just now', 1],
            '.5' => ['%d minutes ago', 60],
            '1.5' => ['about an hour ago', 1],
            '24' => ['about %d hours ago', 1],
            '48' => ['yesterday', 1],
            '168' => ['about %d days ago', 1/24],
            '252' => ['last week', 1],
            '672' => ['about %d weeks ago', 1/168],
            '1080' => ['last month', 1],
            '8760' => ['about %d months ago', 1/672],
            '13140' => ['last year', 1],
        ];

        foreach ($formulas as $maxHours => list($format, $multiplier)) {
            if ($numHours < $maxHours) {
                return sprintf($format, round($numHours * $multiplier));
            }
        }

        return sprintf('about %s years ago', round($numHours/8064));
    }
}