Метод format класса DateInterval
Метод format класса DateInterval преобразует временной интервал в строковое представление согласно указанному формату. В качестве параметра принимает строку формата, содержащую специальные символы, и возвращает отформатированную строку.
Синтаксис
phppublic DateInterval::format(string $format): string
Специальные символы
| Спецификатор | Описание | Пример |
|---|---|---|
%Y |
Количество лет (минимум 2 цифры) |
01, 12 |
%y |
Количество лет (без дополнения нулями) | 1, 12 |
%M |
Количество месяцев (минимум 2 цифры) |
01, 11 |
%m |
Количество месяцев (без дополнения нулями) | 1, 11 |
%D |
Количество дней (минимум 2 цифры) |
01, 31 |
%d |
Количество дней (без дополнения нулями) | 1, 31 |
%H |
Количество часов (минимум 2 цифры) |
01, 23 |
%h |
Количество часов (без дополнения нулями) | 1, 23 |
%I |
Количество минут (минимум 2 цифры) |
01, 59 |
%i |
Количество минут (без дополнения нулями) | 1, 59 |
%S |
Количество секунд (минимум 2 цифры) |
01, 59 |
%s |
Количество секунд (без дополнения нулями) | 1, 59 |
%R |
Знак интервала (+ или -) | +, - |
%r |
Знак интервала с явным указанием (- при отрицательном) | , - |
%% |
Символ процента | % |
Пример
Форматирование интервала в днях и часах:
php<?php
$interval = new DateInterval('P2DT5H');
echo $interval->format('%d days, %h hours');
?>
Результат выполнения кода:
php'2 days, 5 hours'
Пример
Форматирование интервала в полном представлении:
php<?php
$interval = new DateInterval('P1Y3M5DT7H10M');
echo $interval->format('%y years %m months %d days %h hours %i minutes');
?>
Результат выполнения кода:
php'1 years 3 months 5 days 7 hours 10 minutes'
Пример
Форматирование интервала с ведущими нулями:
php<?php
$interval = new DateInterval('PT5H3M');
echo $interval->format('%H:%I');
?>
Результат выполнения кода:
php'05:03'
Смотрите также
-
класс
DateInterval,
который представляет временной интервал -
метод
DateTime::format,
который форматирует дату и время -
функцию
date,
которая форматирует временную метку