
Функціональний блок DT2STR перетворює час у рядок за вказаним форматом.
Вхід визначає дату у DT#, яка використовується для обчислення. Якщо дата не вказана, то обчислюється з часовим штампом 0.
Цим входом визначається формат у вигляді рядка. Якщо значення не встановлено або залишено порожнім, то використовується рядок "Y-m-d H:i:s".
Підказка: Щоб вивести букву або d, кожну букву потрібно позначити символами екранування \. Наприклад: "\d\a\y: d" виводить "day: 01".
| Символи формату | Опис | Приклад значень повернення |
|---|---|---|
| День | ||
| d | День місяця, двозначне з ведучим нулем | 01 до 31 |
| D | День тижня, скорочено до трьох букв | Mon до Sun |
| j | День місяця без ведучих нулів | 1 до 31 |
| l (мале 'L') | Повне написання дня тижня | Sunday до Saturday |
| N | Числове представлення дня тижня відповідно до ISO-8601 | 1 (для понеділка) до 7 (для неділі) |
| S | Додаток англійського переліку для дня місяця, два символи | st, nd, rd або th. Рекомендується для використання з j. |
| w | Числовий день тижня | 0 (для неділі) до 6 (для суботи) |
| z | День року (починаючи з 0) | 0 до 365 |
| Тиждень | ||
| W | Номер тижня року відповідно до ISO-8601, тиждень починається з понеділка | Приклад: 42 (42-й тиждень року) |
| Місяць | ||
| F | Повне написання місяця, як January або March | January до December |
| m | Місяць у числовому вигляді, з ведучими нулями | 01 до 12 |
| M | Назва місяця скорочено до трьох букв | Jan до Dec |
| n | Числове значення місяця, без ведучих нулів | 1 до 12 |
| t | Кількість днів у вказаному місяці | 28 до 31 |
| Рік | ||
| L | Високосний рік або ні | 1 для високосного року, інакше 0 |
| o | Рік календарного тижня відповідно до ISO-8601. Це дає таке ж значення, як і Y, за винятком випадків, коли ISO-календарний тиждень (W) належить попередньому або наступному року, при цьому використовується саме той рік. | Приклади: 1999 або 2003 |
| Y | Чотиризначне числове значення року | Приклади: 1999 або 2003 |
| y | Числове значення року, двозначне | Приклади: 99 або 03 |
| Час | ||
| a | Мале: Ante meridiem (ранок) і Post meridiem (після полудня) | am або pm |
| A | Велике: Ante meridiem (ранок) і Post meridiem (після полудня) | AM або PM |
| B | Swatch-Internet-Час | 000 до 999 |
| g | Година у 12-годинному форматі, без ведучих нулів | 1 до 12 |
| G | Година у 24-годинному форматі, без ведучих нулів | 0 до 23 |
| h | Година у 12-годинному форматі, з ведучими нулями | 01 до 12 |
| H | Година у 24-годинному форматі, з ведучими нулями | 00 до 23 |
| i | Хвилини, з ведучими нулями | 00 до 59 |
| s | Секунди, з ведучими нулями | 00 до 59 |
| u | Мікросекунди. Завжди виводить 000000. | Приклад: 000000 |
| Часовий пояс | ||
| e | Ідентифікатор часового поясу | Приклади: UTC, GMT, Atlantic/Azores |
| I (велике 'i') | Чи належить дата до літнього часу | 1 для літнього часу, інакше 0. |
| O | Різниця часу з Greenwich time (GMT) у годинах | Приклад: +0200 |
| P | Різниця часу з Greenwich time (GMT) у годинах з двокрапкою між годинами та хвилинами | Приклад: +02:00 |
| T | Скорочення часового поясу | Приклади: EST, MDT... |
| Z | Зсув часового поясу в секундах. Зсув для часових поясів на захід від UTC завжди негативний, а для часових поясів на схід від UTC завжди позитивний. | -43200 до 50400 |
| z | Повертає день року без ведучого нуля | |
| Повне дата/час | ||
| c | ISO 8601 Дата | 2004-02-12T15:19:21+00:00 |
| r | Формат дати відповідно до « RFC 2822 » | Приклад: Thu, 21 Dec 2000 16:01:07 +0200 |
| U | Секунди від початку UNIX-епохи (January 1 1970 00:00:00 GMT) | Дивіться також функціональний блок TIME |
Вихід повертає рядок з вказаним форматом.