gtvolk\WorkingTime\WorkingTime

Complexity

Total Complexity

47

Size/Duplication

Total Lines	376
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	0

Test Coverage

Coverage

93.08%

Importance

Changes	1
Bugs	0	Features	0

16 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	7	2
A	buildDataPartString()	0	10	2
A	buildDate()	0	8	2
A	isHoliday()	0	10	2
A	isWeekend()	0	10	2
A	isWorkingDate()	0	10	3
B	isWorkingTime()	0	21	5
A	nextWorkingDay()	0	14	3
B	nextWorkingTime()	0	35	5
A	nextWorkingDayStart()	0	8	1
A	nextWorkingDayEnd()	0	8	1
A	getJobMinutesInDay()	0	17	3
B	modifyDate()	0	24	4
A	modify()	0	14	3
C	calculatingWorkingTime()	0	34	7
A	validateDate()	0	5	2

<?php
/**
 * @copyright 2016, Aleksandr Bushlanov
 * @package gtvolk\WorkingTime
 * @link https://github.com/GT-Volk/
 * @license https://github.com/GT-Volk/working-time/blob/master/LICENSE.md
 */

namespace gtvolk\WorkingTime;

/**
 * Класс рассчитывает временнЫе интервалы, учитывая рабочие часы и выходные дни.
 *
 * @property \DateTime $dateTime
 * @property array $workingDays
 * @property array $weekends
 * @property array $holidays
 *
 * @since  1.0.3
 *
 * @author Aleksandr Bushlanov <alex@bushlanov.pro>
 */
class WorkingTime
{
    /**
     * @var \DateTime
     */
    public $dateTime;

    /**
     * @var array
     */
    public $workingDays;

    /**
     * @var array
     */
    public $weekends;

    /**
     * @var array
     */
    public $holidays;

    /**
     * WorkingTime constructor.
     *
     * @param array $workTimeConfig
     * @param string $dateTime
     */
    public function __construct(array $workTimeConfig, string $dateTime = 'now')
    {
        $this->dateTime = new \DateTime($dateTime);
        foreach ($workTimeConfig as $name => $value) {
            $this->$name = $value;
        }
    }

    /**
     * Фурмирует строку дня.
     * @param null|string $date
     * @param string $format
     * @return string
     */
    private function buildDataPartString(?string $date, string $format): string
    {
        if ($date === null) {
            $day = date($format, $this->dateTime->getTimestamp());
        } else {
            $day = date($format, strtotime($date));
        }

        return $day;
    }

    /**
     * Формирует дату из строки.
     *
     * @param string $date
     * @return \DateTime
     */
    private function buildDate(string $date = null): \DateTime
    {
        if ($date === null) {
            return new \DateTime($this->dateTime->format('Y-m-d H:i'));
        } else {
            return new \DateTime($date);
        }
    }

    /**
     * Проверяет является ли дата праздничным днём.
     *
     * @param string $date
     * @return bool
     */
    public function isHoliday(string $date = null): bool
    {
        if (empty($this->holidays)) {
            // Если не указаны праздничные дни, то день рабочий.
            return false;
        }

        $day = $this->buildDataPartString($date, 'm-d');
        return in_array($day, $this->holidays, false);
    }

    /**
     * Проверяет является ли дата выходным днём.
     *
     * @param string $date
     * @return bool
     */
    public function isWeekend(string $date = null): bool
    {
        if (empty($this->weekends)) {
            // Если не указаны выходные дни, то день рабочий.
            return false;
        }

        $day = $this->buildDataPartString($date, 'w');
        return in_array($day, $this->weekends, false);
    }

    /**
     * Проверяет евляется ли дата рабочим днём.
     *
     * Формат даты - "Y-m-d"
     * @param string $date
     * @return bool
     */
    public function isWorkingDate(string $date = null): bool
    {
        if ($this->isWeekend($date) || $this->isHoliday($date)) {
            // Выходной или праздничный день
            return false;
        } else {
            // Рабочий день
            return true;
        }
    }

    /**
     * Проверяет евляется ли время рабочим.
     *
     * @param string|null $time Формат времени - "H:i" или полный "Y-m-d H:i"
     * @return bool
     * @throws \InvalidArgumentException
     */
    public function isWorkingTime(string $time = null): bool
    {
        if ($time === null) {
            $dateTime = $this->dateTime;
        } else {
            if (self::validateDate($time, 'H:i')) {
                $dateTime = new \DateTime($this->dateTime->format('Y-m-d') . ' ' . $time);
            } elseif (self::validateDate($time, 'Y-m-d H:i')) {
                $dateTime = new \DateTime($time);
            } else {
                throw new \InvalidArgumentException("Date `{$time}` isn't a valid date. Dates should be formatted as Y-m-d or H:i, e.g. `2016-10-27` or `17:30`.");
            }
        }

        list($jobStart, $jobEnd) = explode('-', $this->workingDays[$dateTime->format('w')]);

        $dtStart = new \DateTime($dateTime->format('Y-m-d') . ' ' . $jobStart);
        $dtEnd = new \DateTime($dateTime->format('Y-m-d') . ' ' . $jobEnd);

        return $dateTime > $dtStart && $dateTime < $dtEnd;
    }

    /**
     * Возвращает следующий рабочий день.
     *
     * @param string|null $date Формат даты - "Y-m-d"
     * @return string
     */
    public function nextWorkingDay(string $date = null): string
    {
        if ($date === null) {
            $dateTime = new \DateTime($this->dateTime->format('Y-m-d'));
        } else {
            $dateTime = new \DateTime($date);
        }

        do {
            $dateTime->modify('+1 day');
        } while (!$this->isWorkingDate($dateTime->format('Y-m-d')));

        return $dateTime->format('Y-m-d');
    }

    /**
     * Возвращает ближайшее рабочее время. Либо null если текущее время уже рабочее.
     *
     * @param string|null $date
     * @return null|string
     */
    public function nextWorkingTime(string $date = null): ?string
    {
        $dateTime = $this->buildDate($date);
        $nextWorkingTime = null;

        // Если дня нет в конфиге считаем его выходным
        if (!array_key_exists($dateTime->format('w'), $this->workingDays)) {
            $nextWorkingDay = $this->nextWorkingDay($dateTime->format('Y-m-d'));
            $nWDateTime = new \DateTime($nextWorkingDay);
            $workTime = explode('-', $this->workingDays[$nWDateTime->format('w')]);
            return $nextWorkingDay . ' ' . $workTime[0];
        }

        list($jobStart, $jobEnd) = explode('-', $this->workingDays[$dateTime->format('w')]);

        if ($this->isWorkingDate($dateTime->format('Y-m-d'))) { // Если день рабочий проверяем время

            $dtStart = new \DateTime($dateTime->format('Y-m-d') . ' ' . $jobStart);
            $dtEnd = new \DateTime($dateTime->format('Y-m-d') . ' ' . $jobEnd);

            // Если начало дня еще не наступило (утро) возвращаем указанную дату + время
            if ($dateTime < $dtStart) {
                $nextWorkingTime = $dateTime->format('Y-m-d') . ' ' . $jobStart;
            } elseif ($dateTime >= $dtEnd) { // Если рабочий день уже закончился
                // Ищем следующий рабочий день и выводим его + время начало дня
                $nextWorkingTime = $this->nextWorkingDay($dateTime->format('Y-m-d')) . ' ' . $jobStart;
            }
        } else { // Если день не рабочий

            // Ищем следующий рабочий день и выводим его + время начало дня
            $nextWorkingTime = $this->nextWorkingDay($dateTime->format('Y-m-d')) . ' ' . $jobStart;
        }

        return $nextWorkingTime;
    }

    /**
     * Возвращает дату время начала следующего дня.
     *
     * @param string|null $date
     * @return string
     */
    public function nextWorkingDayStart(string $date = null): string
    {
        $nextWorkingDayDT = new \DateTime($this->nextWorkingDay($date));
        $day = $nextWorkingDayDT->format('w');
        $jobStart = explode('-', $this->workingDays[$day])[0];

        return $nextWorkingDayDT->format('Y-m-d') . ' ' . $jobStart;
    }

    /**
     * Возвращает дату время начала следующего дня.
     *
     * @param string|null $date
     * @return string
     */
    private function nextWorkingDayEnd(string $date = null): string
    {
        $nextWorkingDayDT = new \DateTime($this->nextWorkingDay($date));
        $day = $nextWorkingDayDT->format('w');
        $jobEnd = explode('-', $this->workingDays[$day])[1];

        return $nextWorkingDayDT->format('Y-m-d') . ' ' . $jobEnd;
    }

    /**
     * Возвращает длинну рабочего дня в минутах.
     *
     * @param string|null $date Формат даты - "Y-m-d"
     * @return int
     */
    public function getJobMinutesInDay(string $date = null): int
    {
        $day = $this->buildDataPartString($date, 'w');
        $nextWorkingTime = $this->nextWorkingTime($date ?? $this->dateTime->format('Y-m-d H:i'));

        list($jobStart, $jobEnd) = explode('-', $this->workingDays[$day]);
        // Считаем остаток рабочего времени
        if ($nextWorkingTime === null) {
            $jobStart = ($date === null ? date('H:i', $this->dateTime->getTimestamp()) : date('H:i', strtotime($date)));
        }

        $dtStart = new \DateTime($jobStart);
        $dtEnd = new \DateTime($jobEnd);
        $diff = $dtEnd->diff($dtStart);

        return ($diff->h * 60 + $diff->i);
    }

    /**
     * Прибавляет заданное количество минут к дате с учетом рабочего времени.
     *
     * @param int $minutes
     * @param string $date
     * @return \DateTime
     */
    private function modifyDate(int $minutes, string $date): \DateTime
    {
        $dateTime = new \DateTime($date);
        $jobMinutesInDay = $this->getJobMinutesInDay($date);

        // Если длинна дня больше чем время модификации
        if ($jobMinutesInDay > $minutes) {
            $dateTime->modify("+$minutes minutes");
        } else { // Если длинна дня меньше чем время модификации
            do {
                $dateTime->modify("+$jobMinutesInDay minutes");
                $minutes -= $jobMinutesInDay;
                $nextWorkingTime = $this->nextWorkingTime($dateTime->format('Y-m-d H:i'));
                $dateTime = new \DateTime($nextWorkingTime);
                $jobMinutesInNextDay = $this->getJobMinutesInDay($dateTime->format('Y-m-d H:i'));
                if ($jobMinutesInNextDay > $minutes) {
                    $dateTime->modify("+$minutes minutes");
                    $minutes = 0;
                }
            } while ($minutes > 0);
        }

        return $dateTime;
    }

    /**
     * Прибавляет заданное количество минут к дате с учетом рабочего времени.
     *
     * @param int $minutes
     * @param string $date
     * @return string
     */
    public function modify(int $minutes, string $date = null): string
    {
        $nextWorkingTime = $this->nextWorkingTime($date);
        // Если дата вне рабочего времени
        if ($nextWorkingTime !== null) {
            $dateTime = $this->modifyDate($minutes, $nextWorkingTime);
        } else { // если дата в пределах рабочего времени
            $dateTime = $this->modifyDate($minutes, $date ?? $this->dateTime->format('Y-m-d H:i'));
        }
        if ($date === null) {
            $this->dateTime->setTimestamp($dateTime->getTimestamp());
        }
        return $dateTime->format('Y-m-d H:i');
    }

    /**
     * Возвращает рабочее время в минутах в заданном временном интервале.
     *
     * @param string $startDate
     * @param string $endDate
     * @return int
     * @throws \InvalidArgumentException
     */
    public function calculatingWorkingTime(string $startDate, string $endDate): int
    {
        if (!self::validateDate($startDate) || !self::validateDate($endDate)) {
            throw new \InvalidArgumentException("Date isn't a valid date. Dates should be formatted as Y-m-d H:i:s, e.g. `2016-10-27 17:30:00`.");
        }

        $dtStart = $this->buildDate($startDate);
        $dtEnd = $this->buildDate($endDate);

        $diff = $dtEnd->diff($dtStart);
        $diffMinutes = $diff->d * 1440 + $diff->h * 60 + $diff->i;
        $jobMinutesInDay = $this->getJobMinutesInDay($dtStart->format('Y-m-d H:i'));

        // Если разница во времени больше длинны рабочего дня
        if ($diffMinutes > $jobMinutesInDay) {

            $nextWorkingDayStartDT = new \DateTime($this->nextWorkingDayStart($dtStart->format('Y-m-d')));
            $nextWorkingDayEndDT = new \DateTime($this->nextWorkingDayEnd($dtStart->format('Y-m-d')));

            // Дата находится в промежутке ДО наступления следующего рабочего времени
            if ($nextWorkingDayStartDT > $dtEnd) {
                return $jobMinutesInDay; // Возвращает остатки рабочего времени
            } elseif ($nextWorkingDayStartDT < $dtEnd && $dtEnd < $nextWorkingDayEndDT) {
                // Дата в промежутке следующего рабочего дня
                $nextDiff = $dtEnd->diff($nextWorkingDayStartDT);
                $nextDiffMinutes = $nextDiff->d * 1440 + $nextDiff->h * 60 + $nextDiff->i;
                return $nextDiffMinutes + $jobMinutesInDay;
            }

            return 1;
        } else {
            return $diffMinutes;
        }
    }

    /**
     * Проверяет является ли строка корректной датой.
     *
     * @param $date
     * @param string $format
     * @return bool
     */
    public static function validateDate(string $date, string $format = 'Y-m-d H:i:s'): bool
    {
        $vDate = \DateTime::createFromFormat($format, $date);
        return $vDate && $vDate->format($format) === $date;
    }
}