Функциональный блок DT2STR
Функциональный блок DT2STR преобразует время с указанным форматом в строку.
Вход DT
Вход определяет дату в DT#, которая используется для расчета. Если не указана дата, то расчет производится с временной меткой 0.
Вход FORMAT
С помощью входа определяется формат как строка. Если не установлено значение или оставлено пустым, то предполагается строка "Y-m-d H:i:s".
Совет: Чтобы вывести букву или d, каждый символ должен быть помечен символами экранирования \. Например: "\d\a\y: d" выводит "day: 01".
| Символы формата | Описание | Примеры возвращаемых значений |
|---|---|---|
| День | ||
| d | День месяца, 2-значное с ведущим нулем | 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 Time | 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 | Разница во времени с Гринвичским временем (GMT) в часах | Пример: +0200 |
| P | Разница во времени с Гринвичским временем (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 |
Выход STR
Выход возвращает строку с указанным форматом.