DateInterval::format

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

DateInterval::format — Форматує інтервал

Опис

public DateInterval::format(string $format): string

Форматує інтервал.

Список параметрів

format

В рядку format розпізнаються такі символи. Кожному такому символу має передувати знак відсотка (% Символ у рядкуformatОпис Приклад значения%Символ% % Y Роки, число, щонайменше дві цифри з провідними нулями 01 03 y Роки, число 3 M Місяці, число, щонайменше дві цифри з провідними нулями 01 03 12 m Місяці, число 3 12 D Дні, число, мінімум дві цифри з провідними нулями 01 03 31 dДни, число 3 31 a Загальна кількість днів як результат виконання DateTime::diff(), либоunknown 4 18 8123 H Годинник, число, мінімум дві цифри з провідними нулями 01 03 23 h Годинник, число 3 23 I Хвилини, число, щонайменше дві цифри з провідними нулями 01 03 59 i Хвилини, число 3 59 S Секунди, число, щонайменше дві цифри з провідними нулями 01 03 57 s Секунди, число 3 57 F Мікросекунди, число як мінімум 6 цифр з ведучим 0 007701 052738 428291 f Мікросекунди, число 7701 52738 428291 R Знак-"при негативному числі,"+ при позитивному - + r Знак-при негативному числі, порожньо при позитивному -,

Значення, що повертаються

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

список змін

Версия	Опис
7.2.12	ФорматFиf тепер завжди буде позитивним.
7.1.0	Додані символи, що форматують. Fиf

Приклади

Приклад #1 Приклад использованияDateInterval

Loading...
▶

Результат виконання наведеного прикладу:

4 days

Приклад #2DateIntervalи перенос единиц

Loading...
▶

Результат виконання наведеного прикладу:

32 days

Приклад #3DateInterval і DateTime::diff() з модифікаторами %a та %d

Loading...
▶

Результат виконання наведеного прикладу:

31 total days
1 month, 0 days

Примітки

Зауваження :

МетодDateInterval::format() не робить перерахунку та перенесення одиниць часу при переповненні значень дат. Це очікувана поведінка, оскільки неможливо реалізувати перенесення при значеннях, наприклад, "32 дні", які можуть інтерпретуватися по-різному, починаючи "1 місяць та 4 дні" та закінчуючи "1 місяць та 1 день"

Дивіться також

• DateTime::diff() - Повертає різницю між двома об'єктами DateTime