date.php

См. документацию.

<?php
 
namespace Bitrix\Calendar\Core\Base;
 
use Bitrix\Calendar\Util;
use Bitrix\Main\Type;
use DateTimeZone;
 
class Date extends BaseProperty
{
    private Type\Date $date;
    private $format;

    public static function createDateTimeFromFormat(string $date, string $format): ?Date
    {
        $timeZone = null;
        $entity = \DateTime::createFromFormat($format, $date);
 
        if ($entity && $entity->getTimeZone()->getName() === 'Z')
        {
            $timeZone = new DateTimeZone(Util::DEFAULT_TIMEZONE);
        }
 
        if ($entity)
        {
            return new self(new Type\DateTime($entity->format($format), $format, $timeZone), $format);
        }
 
        return null;
    }

    public static function createDateFromFormat(string $date, string $format): Date
    {
        return new self(new Type\Date($date, $format), $format);
    }

    public function __construct(Type\Date $date = null, string $dateFormat = null)
    {
        $this->date = $date ?? Util::getDateObject(null, false, (new \DateTime())->getTimezone()->getName());
        $this->format = $dateFormat
            ?? $this->date instanceof Type\DateTime
                ? Type\Date::convertFormatToPhp(FORMAT_DATETIME)
                : Type\Date::convertFormatToPhp(FORMAT_DATE)
        ;
    }

    public function getFields(): array
    {
        return [
            'date' => $this->date->format($this->format),
            'timezone' => ($this->date instanceof Type\DateTime) ? $this->date->getTimeZone()->getName() : null,
        ];
    }

    public function toString(): string
    {
        return $this->date->format($this->format);
    }

    public function setTimezone(DateTimeZone $timeZone): Date
    {
        if ($this->date instanceof Type\DateTime)
        {
            $this->date->setTimeZone($timeZone);
        }
 
        return $this;
    }

    public function format(string $format = null): string
    {
        return $this->date->format($format ?? $this->format);
    }

    public function add(string $addTime): Date
    {
        $object = clone $this;
        $object->date->add($addTime);
 
        return $object;
    }

    public function getTimestamp(): int
    {
        return $this->date->getTimestamp();
    }

    public function sub(string $subtractTime): Date
    {
        $object = clone $this;
        $object->date->add("-{$subtractTime}");
 
        return $object;
    }

    public function __clone()
    {
        $this->date = clone $this->date;
    }

    public function setTime(int $hour, int $minutes, int $seconds): Date
    {
        if ($this->date instanceof Type\DateTime)
        {
            $this->date->setTime($hour, $minutes, $seconds);
        }
 
        return $this;
    }

    public function resetTime(): Date
    {
        return $this->setTime(0,0,0);
    }

    public function isDateTime(): bool
    {
        return $this->date instanceof Type\DateTime;
    }

    public function getDate(): Type\Date
    {
        return $this->date;
    }

    public function getHour(): int
    {
        return (int)$this->date->format('H');
    }

    public function getMinutes(): int
    {
        return (int)$this->date->format('i');
    }

    public function getSeconds(): int
    {
        return (int)$this->date->format('s');
    }

    public function getMonth(): int
    {
        return (int)$this->date->format('m');
    }

    public function getDay(): int
    {
        return (int)$this->date->format('d');
    }

    public function getYear(): int
    {
        return (int)$this->date->format('Y');
    }

    public function isStartDay(): bool
    {
        return $this->getHour() === 0 && $this->getMinutes() === 0 && $this->getSeconds() === 0;
    }

    public function setDateTimeFormat(string $format): Date
    {
        $this->format = $format;
 
        return $this;
    }

    public function getDateTimeFormat(): string
    {
        return $this->format;
    }
}