Клас DateTime

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

Вступ

Подання дати та часу.

Клас поводиться так само, як і DateTimeImmutable, крім того, що об'єкти модифікуються самі під час виклику таких методів модифікації, як DateTime::modify()

Увага

Виклик методів для об'єктів класу DateTime змінить інформацію, укладену в цих об'єктах, якщо ви хочете запобігти цьому, вам доведеться використовувати оператор clone створення нового об'єкта. Використовуйте клас DateTimeImmutable замість DateTime, щоб отримати рекомендовану поведінку за промовчанням.

Огляд класів

    
     class DateTime
    

    
     implements
      DateTimeInterface {

    /* Наследуемые константы */
    
     public
     const
     string
      DateTimeInterface::ATOM = "Y-m-d\\TH:i:sP";
public
     const
     string
      DateTimeInterface::COOKIE = "l, d-M-Y H:i:s T";
public
     const
     string
      DateTimeInterface::ISO8601 = "Y-m-d\\TH:i:sO";
public
     const
     string
      DateTimeInterface::ISO8601_EXPANDED = "X-m-d\\TH:i:sP";
public
     const
     string
      DateTimeInterface::RFC822 = "D, d M y H:i:s O";
public
     const
     string
      DateTimeInterface::RFC850 = "l, d-M-y H:i:s T";
public
     const
     string
      DateTimeInterface::RFC1036 = "D, d M y H:i:s O";
public
     const
     string
      DateTimeInterface::RFC1123 = "D, d M Y H:i:s O";
public
     const
     string
      DateTimeInterface::RFC7231 = "D, d M Y H:i:s \\G\\M\\T";
public
     const
     string
      DateTimeInterface::RFC2822 = "D, d M Y H:i:s O";
public
     const
     string
      DateTimeInterface::RFC3339 = "Y-m-d\\TH:i:sP";
public
     const
     string
      DateTimeInterface::RFC3339_EXTENDED = "Y-m-d\\TH:i:s.vP";
public
     const
     string
      DateTimeInterface::RSS = "D, d M Y H:i:s O";
public
     const
     string
      DateTimeInterface::W3C = "Y-m-d\\TH:i:sP";


    /* Методы */
    
   public __construct(string $datetime = "now", ?DateTimeZone $timezone = null)

    public add(DateInterval $interval): DateTime
public static createFromFormat(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTime|false
public static createFromImmutable(DateTimeImmutable $object): static
public static createFromInterface(DateTimeInterface $object): DateTime
public modify(string $modifier): DateTime|false
public static __set_state(array $array): DateTime
public setDate(int $year, int $month, int $day): DateTime
public setISODate(int $year, int $week, int $dayOfWeek = 1): DateTime
public setTime(    int $hour,    int $minute,    int $second = 0,    int $microsecond = 0): DateTime
public setTimestamp(int $timestamp): DateTime
public setTimezone(DateTimeZone $timezone): DateTime
public sub(DateInterval $interval): DateTime

    public diff(DateTimeInterface $targetObject, bool $absolute = false): DateInterval
public format(string $format): string
public getOffset(): int
public getTimestamp(): int
public getTimezone(): DateTimeZone|false
public __wakeup(): void

  }

список змін

Версия	Опис
7.2.0	Константи класу тепер DateTime визначено в DateTimeInterface
7.1.0	Конструктор класу DateTime тепер включає поточні мікросекунди. До цього він завжди ініціалізував мікросекунди зі значенням

Зміст

• DateTime::add— Змінює об'єкт DateTime, додаючи кількість днів, місяців, років, годин, хвилин та секунд
• DateTime::__construct - Конструктор класу DateTime
• DateTime::createFromFormat— Розбирає рядок із датою згідно з вказаним форматом
• DateTime::createFromImmutable— Повертає екземпляр DateTime інкапсулюючий заданий об'єкт DateTimeImmutable
• DateTime::createFromInterface— Повертає новий об'єкт DateTime, створений із переданого об'єкта, який реалізує інтерфейс DateTimeInterface
• DateTime::getLastErrors - Псевдонім DateTimeImmutable::getLastErrors
• DateTime::modify - Зміна тимчасової мітки
• DateTime::__set_state - Обробник__set_state
• DateTime::setDate - Встановлює дату
• DateTime::setISODate— Встановлює дату ISO
• DateTime::setTime - Встановлює час
• DateTime::setTimestamp— Встановлює дату та час на основі мітки часу Unix
• DateTime::setTimezone— Встановлює часовий пояс для об'єкта класу DateTime
• DateTime::sub— Віднімає дні, місяці, роки, години, хвилини та секунди з об'єкта DateTime