« DateTimeZone::listIdentifiersDateInterval::\_\_construct »PHP ManualДата час

Клас DateInterval

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

Вступ

Подає інтервали дат.

Інтервал дат зберігає або певний фіксований час (у роках, місяцях, днях, годинах тощо) або відносний рядок часу у форматі, який підтримує конструктор DateTimeImmutable і DateTime

Більш конкретно, інформація в об'єкті класу DateInterval є інструкцією для переходу від однієї дати/часу до іншої дати/часу. Цей процес не завжди оборотний.

Найпоширенішим способом створення об'єкта DateInterval є обчислення різниці між двома об'єктами дати/часу за допомогою DateTimeInterface::diff()

Оскільки не існує чітко визначеного способу порівняння інтервалів дат, екземпляри DateIntervalявляютсянезрівнянними

Огляд класів


    
     class DateInterval
     {

    /* Свойства */
    
     public
     int
      $y;

    public
     int
      $m;

    public
     int
      $d;

    public
     int
      $h;

    public
     int
      $i;

    public
     int
      $s;

    public
     float
      $f;

    public
     int
      $invert;

    public
     mixed
      $days;

    public
     bool
      $from_string;

    public
     string
      $date_string;


    /* Методы */
    
   public __construct(string $duration)

    public static createFromDateString(string $datetime): DateInterval|false
public format(string $format): string

   }

Властивості

Увага

Доступні властивості, наведені нижче, залежать від версії PHP і повинні розглядатися як доступні лише для читання

y

Кількість років.

m

Кількість місяців.

d

Кількість днів.

h

Кількість годин.

i

Кількість хвилин.

s

Кількість секунд.

f

Кількість мікросекунд у вигляді часток секунди.

invert

Приймає , якщо інтервал представляє негативний період часу та в іншому випадку. Дивіться DateInterval::format()

days

Якщо об'єкт DateInterval створено методом DateTimeImmutable::diff() або DateTime::diff(), то це загальна кількість повних днів між початковою та кінцевою датами В іншому випадку days прийме значення false

from_string

Якщо об'єкт DateInterval був створений методом DateInterval::createFromDateString(), то значение свойства будет**trueи свойство date_string будет заполнено. В противном случае значение свойства будетfalse** та властивості від y до f, invert та days будуть заповнені.

date_string

Строка, используемая в качестве аргумента методаDateInterval::createFromDateString()

список змін

ВерсияОпис
8.2.0Додані властивості from_string та date_string для екземплярів DateInterval, які були створені за допомогою методу DateInterval::createFromDateString()
8.2.0Буде видно тільки значення від yдоfinvertиdays
7.4.0Примірники DateInterval тепер незрівнянні; раніше всі екземпляри DateInterval вважалися рівними.
7.1.0Додано властивість f.

Зміст