DateTimeInterface::format
DateTimeImmutable::format
DateTime::format
date_format
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
DateTimeInterface::format -- DateTimeImmutable::format -- DateTime::format -- date_format — Повертає дату, відформатовану відповідно до переданого формату
Опис
Об'єктно-орієнтований стиль
public DateTimeInterface::format(string $format): string
public DateTimeImmutable::format(string $format): string
public DateTime::format(string $format): string
Процедурний стиль
date_format(DateTimeInterface $object, string $format): string
Повертає рядок дати, перетвореної відповідно до переданого формату.
Список параметрів
object
Тільки для процедурного стилю: об'єкт DateTime, що повертається date_create()
format
Шаблон результуючого рядка (string) з датою. Дивіться параметри форматування нижче. Також існує кілька визначених констант дати/часу, які можна використовувати замість цих параметрів. Наприклад: **DATE_RSS**заменяет шаблон'D, d M Y H:i:s'
В параметреformat розпізнаються такі символи
Символ в строке format | Опис | Приклад возвращаемого значения |
|---|---|---|
| День | --- | --- |
d | День місяця, 2 цифри з провідним нулем | Від 01до31 |
D | Текстова вистава дня тижня, 3 символи | Від MonдоSun |
j | День місяця без ведучого нуля | Від до31 |
l (маленька 'L') | Повне найменування дня тижня | Від SundayдоSaturday |
N | Порядковий номер дня тижня відповідно до стандарту ISO 8601 | Від (понеділок) до 7 (Неділя) |
S | Англійський суфікс порядкового числа місяця, 2 символи | stndrdилиth. . Застосовують спільно з j |
w | Порядковий номер дня тижня | Від (неділя) до6(субота) |
z | Порядковий номер дня у році (починаючи з 0) | Від до365 |
| Тиждень | --- | --- |
W | Порядковий номер тижня року відповідно до стандарту ISO 8601; тижні починаються з понеділка | Наприклад: 42 (42-й тиждень року) |
| Місяць | --- | --- |
F | Повне найменування місяця, наприклад January або March | Від JanuaryдоDecember |
m | Порядковий номер місяця з провідним нулем | Від 01до12 |
M | Скорочена назва місяця, 3 символи | Від JanдоDec |
n | Порядковий номер місяця без провідного нуля | Від до12 |
t | Кількість днів у вказаному місяці | Від 28до31 |
| Рік | --- | --- |
L | Ознака високосного року | якщо рік високосний, інакше |
o | Номер року відповідно до стандарту ISO 8601. Має те саме значення, що й Yкрім випадку, коли номер тижня ISO (W) належить попередньому чи наступному році; тоді буде використано рік цього тижня. | Приклади: 1999или2003 |
X | Розширене повне числове подання року, не менше 4 цифр, - для років до нашої ери та + для років нашої ери. | Приклади: -0055+0787+1999+10191 |
x | Розширене повне числове уявлення, якщо потрібно, або стандартне повне числове уявлення, якщо можливо (наприклад, Y). Не менш як чотири цифри. Для років до нашої ери вказано префікс -. . У років після (і включаючи) 10000 префікс + | Приклади: -005507871999+10191 |
Y | Повне числове подання року, не менше 4 цифр, - для років до н. | Приклади: -005507871999200310191 |
y | Номер року, 2 цифри | Приклади: 9903 |
| Час | --- | --- |
a | Ante meridiem (лат. «до полудня») або Post meridiem (лат. «після полудня») у нижньому регістрі | amилиpm |
A | Ante meridiem або Post meridiem у верхньому регістрі | AMилиPM |
B | Час у форматі Інтернет-часу (альтернативної системи відліку часу доби) | Від 000до999 |
g | Годинник у 12-годинному форматі без провідного нуля | Від до12 |
G | Годинник у 24-годинному форматі без провідного нуля | Від до23 |
h | Годинник у 12-годинному форматі з провідним нулем | Від 01до12 |
H | Годинник у 24-годинному форматі з провідним нулем | Від 00до23 |
i | Хвилини з провідним нулем | Від 00до59 |
s | Секунди з провідним нулем | Від 00до59 |
u | Мікросекунди. Врахуйте, що функція date() завжди повертатиме значення 000000, т. до. вона приймає цілий (int) параметр, тоді як метод DateTime::format() підтримує мікросекунди, якщо об'єкт DateTime створений із ними. | Наприклад: 654321 |
v | Мілісекунди. Зауваження таке саме, як і для u | Приклад: 654 |
| Часовий пояс | --- | --- |
e | Ідентифікатор часового поясу | Приклади: UTCGMTAtlantic/Azores |
I (Заголовна i) | Ознака літнього часу | якщо дата відповідає літньому часу, в іншому випадку |
O | Різниця з часом за Грінвічем без двокрапки між годинами та хвилинами | Наприклад: +0200 |
P | Різниця з часом за Грінвічем з двокрапкою між годинами та хвилинами | Наприклад: +02:00 |
p | Те саме, що і P, але повертаєZ замість +00:00 (доступний, починаючи з PHP 8.0.0) | Наприклад: Zили+02:00 |
T | Абревіатура часового поясу, якщо відома; в іншому випадку зсув за Грінвічем. | Приклади: ESTMDT+05 |
Z | Зміщення часового поясу за секунди. Для часових поясів, розташованих на захід від UTC, повертаються негативні числа, а для розташованих на схід від UTC — позитивні. | Від -43200до50400 |
| Повна дата/час | --- | --- |
c | Дата у форматі стандарту ISO 8601 | 2004-02-12T15:19:21+00:00 |
r | Дата у форматі » RFC 222» RFC 5322 | Наприклад: Thu, 21 Dec 2000 16:01:07 +0200 |
U | Кількість секунд, що минули з початку Епохи Unix (1 січня 1970 00:00:00 GMT) | Смотрите такжеtime() |
Будь-які інші символи, зустрінуті в рядку-шаблоні, будуть виведені в результуючий рядок без змін . Z завжди повертає при использованииgmdate()
Зауваження :
Оскільки ця функція приймає як параметр цілочислові (int) мітки часу, символ форматує
uбуде корисним лише при роботі з функцією date_format() та користувальницькими мітками часу, створеними функцією date_create()
Значення, що повертаються
Повертає рядок із відформатованою датою у разі успішного виконання.
список змін
| Версия | Опис |
|---|---|
| 8.2.0 | Додані символи форматування Xиx |
| 8.0.0 | Доданий символ форматування p |
Приклади
Приклад #1 Приклад використання DateTimeInterface::format()****
Об'єктно-орієнтований стиль
Процедурний стиль
Результат виконання наведеного прикладу:
2000-01-01 00:00:00
Приклад #2 Більше прикладів
Можна запобігти розширенню розпізнаного символу в рядку формату, екрануючи його попереднім зворотним слішем. Якщо символ зі зворотним слешем вже утворює спеціальну послідовність, його також може знадобитися екранувати.
Приклад #3 Екранування символів під час форматування
Для форматування дат іншими мовами замість методу DateTimeInterface::format() можна використовувати метод IntlDateFormatter::format()
Примітки
Цей метод не використовує налаштування локалі. Висновок робиться англійською мовою.
Дивіться також
- date() - Форматує тимчасову мітку Unix