213 lines
		
	
	
		
			6.9 KiB
		
	
	
	
		
			PHP
		
	
	
			
		
		
	
	
			213 lines
		
	
	
		
			6.9 KiB
		
	
	
	
		
			PHP
		
	
	
| <?php
 | |
| 
 | |
| declare(strict_types=1);
 | |
| 
 | |
| namespace Cron;
 | |
| 
 | |
| use DateTimeInterface;
 | |
| use DateTimeZone;
 | |
| 
 | |
| /**
 | |
|  * Hours field.  Allows: * , / -.
 | |
|  */
 | |
| class HoursField extends AbstractField
 | |
| {
 | |
|     /**
 | |
|      * {@inheritdoc}
 | |
|      */
 | |
|     protected $rangeStart = 0;
 | |
| 
 | |
|     /**
 | |
|      * {@inheritdoc}
 | |
|      */
 | |
|     protected $rangeEnd = 23;
 | |
| 
 | |
|     /**
 | |
|      * @var array|null Transitions returned by DateTimeZone::getTransitions()
 | |
|      */
 | |
|     protected $transitions = [];
 | |
| 
 | |
|     /**
 | |
|      * @var int|null Timestamp of the start of the transitions range
 | |
|      */
 | |
|     protected $transitionsStart = null;
 | |
| 
 | |
|     /**
 | |
|      * @var int|null Timestamp of the end of the transitions range
 | |
|      */
 | |
|     protected $transitionsEnd = null;
 | |
| 
 | |
|     /**
 | |
|      * {@inheritdoc}
 | |
|      */
 | |
|     public function isSatisfiedBy(DateTimeInterface $date, $value, bool $invert): bool
 | |
|     {
 | |
|         $checkValue = (int) $date->format('H');
 | |
|         $retval = $this->isSatisfied($checkValue, $value);
 | |
|         if ($retval) {
 | |
|             return $retval;
 | |
|         }
 | |
| 
 | |
|         // Are we on the edge of a transition
 | |
|         $lastTransition = $this->getPastTransition($date);
 | |
|         if (($lastTransition !== null) && ($lastTransition["ts"] > ((int) $date->format('U') - 3600))) {
 | |
|             $dtLastOffset = clone $date;
 | |
|             $this->timezoneSafeModify($dtLastOffset, "-1 hour");
 | |
|             $lastOffset = $dtLastOffset->getOffset();
 | |
| 
 | |
|             $dtNextOffset = clone $date;
 | |
|             $this->timezoneSafeModify($dtNextOffset, "+1 hour");
 | |
|             $nextOffset = $dtNextOffset->getOffset();
 | |
| 
 | |
|             $offsetChange = $nextOffset - $lastOffset;
 | |
|             if ($offsetChange >= 3600) {
 | |
|                 $checkValue -= 1;
 | |
|                 return $this->isSatisfied($checkValue, $value);
 | |
|             }
 | |
|             if ((! $invert) && ($offsetChange <= -3600)) {
 | |
|                 $checkValue += 1;
 | |
|                 return $this->isSatisfied($checkValue, $value);
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         return $retval;
 | |
|     }
 | |
| 
 | |
|     public function getPastTransition(DateTimeInterface $date): ?array
 | |
|     {
 | |
|         $currentTimestamp = (int) $date->format('U');
 | |
|         if (
 | |
|             ($this->transitions === null)
 | |
|             || ($this->transitionsStart < ($currentTimestamp + 86400))
 | |
|             || ($this->transitionsEnd > ($currentTimestamp - 86400))
 | |
|         ) {
 | |
|             // We start a day before current time so we can differentiate between the first transition entry
 | |
|             // and a change that happens now
 | |
|             $dtLimitStart = clone $date;
 | |
|             $dtLimitStart = $dtLimitStart->modify("-12 months");
 | |
|             $dtLimitEnd = clone $date;
 | |
|             $dtLimitEnd = $dtLimitEnd->modify('+12 months');
 | |
| 
 | |
|             $this->transitions = $date->getTimezone()->getTransitions(
 | |
|                 $dtLimitStart->getTimestamp(),
 | |
|                 $dtLimitEnd->getTimestamp()
 | |
|             );
 | |
|             if (empty($this->transitions)) {
 | |
|                 return null;
 | |
|             }
 | |
|             $this->transitionsStart = $dtLimitStart->getTimestamp();
 | |
|             $this->transitionsEnd = $dtLimitEnd->getTimestamp();
 | |
|         }
 | |
| 
 | |
|         $nextTransition = null;
 | |
|         foreach ($this->transitions as $transition) {
 | |
|             if ($transition["ts"] > $currentTimestamp) {
 | |
|                 continue;
 | |
|             }
 | |
| 
 | |
|             if (($nextTransition !== null) && ($transition["ts"] < $nextTransition["ts"])) {
 | |
|                 continue;
 | |
|             }
 | |
| 
 | |
|             $nextTransition = $transition;
 | |
|         }
 | |
| 
 | |
|         return ($nextTransition ?? null);
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * {@inheritdoc}
 | |
|      *
 | |
|      * @param string|null                  $parts
 | |
|      */
 | |
|     public function increment(DateTimeInterface &$date, $invert = false, $parts = null): FieldInterface
 | |
|     {
 | |
|         $originalTimestamp = (int) $date->format('U');
 | |
| 
 | |
|         // Change timezone to UTC temporarily. This will
 | |
|         // allow us to go back or forwards and hour even
 | |
|         // if DST will be changed between the hours.
 | |
|         if (null === $parts || '*' === $parts) {
 | |
|             if ($invert) {
 | |
|                 $date = $date->sub(new \DateInterval('PT1H'));
 | |
|             } else {
 | |
|                 $date = $date->add(new \DateInterval('PT1H'));
 | |
|             }
 | |
| 
 | |
|             $date = $this->setTimeHour($date, $invert, $originalTimestamp);
 | |
|             return $this;
 | |
|         }
 | |
| 
 | |
|         $parts = false !== strpos($parts, ',') ? explode(',', $parts) : [$parts];
 | |
|         $hours = [];
 | |
|         foreach ($parts as $part) {
 | |
|             $hours = array_merge($hours, $this->getRangeForExpression($part, 23));
 | |
|         }
 | |
| 
 | |
|         $current_hour = (int) $date->format('H');
 | |
|         $position = $invert ? \count($hours) - 1 : 0;
 | |
|         $countHours = \count($hours);
 | |
|         if ($countHours > 1) {
 | |
|             for ($i = 0; $i < $countHours - 1; ++$i) {
 | |
|                 if ((!$invert && $current_hour >= $hours[$i] && $current_hour < $hours[$i + 1]) ||
 | |
|                     ($invert && $current_hour > $hours[$i] && $current_hour <= $hours[$i + 1])) {
 | |
|                     $position = $invert ? $i : $i + 1;
 | |
| 
 | |
|                     break;
 | |
|                 }
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         $target = (int) $hours[$position];
 | |
|         $originalHour = (int)$date->format('H');
 | |
| 
 | |
|         $originalDay = (int)$date->format('d');
 | |
|         $previousOffset = $date->getOffset();
 | |
| 
 | |
|         if (! $invert) {
 | |
|             if ($originalHour >= $target) {
 | |
|                 $distance = 24 - $originalHour;
 | |
|                 $date = $this->timezoneSafeModify($date, "+{$distance} hours");
 | |
| 
 | |
|                 $actualDay = (int)$date->format('d');
 | |
|                 $actualHour = (int)$date->format('H');
 | |
|                 if (($actualDay !== ($originalDay + 1)) && ($actualHour !== 0)) {
 | |
|                     $offsetChange = ($previousOffset - $date->getOffset());
 | |
|                     $date = $this->timezoneSafeModify($date, "+{$offsetChange} seconds");
 | |
|                 }
 | |
| 
 | |
|                 $originalHour = (int)$date->format('H');
 | |
|             }
 | |
| 
 | |
|             $distance = $target - $originalHour;
 | |
|             $date = $this->timezoneSafeModify($date, "+{$distance} hours");
 | |
|         } else {
 | |
|             if ($originalHour <= $target) {
 | |
|                 $distance = ($originalHour + 1);
 | |
|                 $date = $this->timezoneSafeModify($date, "-" . $distance . " hours");
 | |
| 
 | |
|                 $actualDay = (int)$date->format('d');
 | |
|                 $actualHour = (int)$date->format('H');
 | |
|                 if (($actualDay !== ($originalDay - 1)) && ($actualHour !== 23)) {
 | |
|                     $offsetChange = ($previousOffset - $date->getOffset());
 | |
|                     $date = $this->timezoneSafeModify($date, "+{$offsetChange} seconds");
 | |
|                 }
 | |
| 
 | |
|                 $originalHour = (int)$date->format('H');
 | |
|             }
 | |
| 
 | |
|             $distance = $originalHour - $target;
 | |
|             $date = $this->timezoneSafeModify($date, "-{$distance} hours");
 | |
|         }
 | |
| 
 | |
|         $date = $this->setTimeHour($date, $invert, $originalTimestamp);
 | |
| 
 | |
|         $actualHour = (int)$date->format('H');
 | |
|         if ($invert && ($actualHour === ($target - 1) || (($actualHour === 23) && ($target === 0)))) {
 | |
|             $date = $this->timezoneSafeModify($date, "+1 hour");
 | |
|         }
 | |
| 
 | |
|         return $this;
 | |
|     }
 | |
| }
 |