Статья была полезной?
На платформе доступны переменные для вывода дат, которые можно использовать на страницах сайта, в виджетах, рассылках, процессах или уроках.
Переменная today
Переменная {today} отображает сегодняшнюю дату в формате «dd.mm (полностью)».
Обратите внимание
При добавлении переменной на страницу, в урок или виджет обязательно включите опцию «Заменять переменные пользователя», чтобы подставилось указанное значение.
Переменная today
Отображение значения вместо переменной
Переменная today plus
Переменная {today plus} — отображает сегодняшнюю дату + Х дней в формате «dd.mm.yyyy».
Например, {today} = 20 ноября, а {today plus="10"} = 30.11.2024
Обратите внимание
При добавлении переменной на страницу, в урок или виджет обязательно включите опцию «Заменять переменные пользователя», чтобы подставилось указанное значение.
Переменная в конструкторе
Отображение значения вместо переменной
Переменная nextweekday
Переменная {nextweekday} выводит даты ближайшего указанного дня недели в формате «dd.mm.yyyy».
К переменной nextweekday можно добавить атрибуты day и today:
- day — обязательный, название дня недели на английском языке;
- today — yes/no или 1/0 — разрешение сегодняшнего дня.
Если today = yes, то проверка начинается с сегодняшнего дня, иначе — с завтрашнего.
Например, если сегодня 20.11.2024 (среда), то переменные отобразят следующие значения:
{nextweekday day="wednesday" today="no"} = 27.11.2024
{nextweekday day="wednesday" today="yes"} = 20.11.2024
{nextweekday day="friday" today="yes"} = 22.1.2024
Дни недели:
Monday — понедельник.
Tuesday — вторник.
Wednesday — среда.
Thursday — четверг.
Friday — пятница.
Saturday — суббота.
Sunday — воскресенье.
Переменные в конструкторе
Отображение значений переменных
Форматирование вывода дат
По умолчанию даты выводятся в формате:
| Переменная | Пример вывода |
{today} | 26 ноября |
{today plus},{nextweekday}, {deal.created_at}, {deal.payed_at} | 26.11.2019 |
{deal.created_at_datetime}, {deal.payed_at_datetime} | 26.11.2019 14:28 |
{start_at}, {finish_at} | 26 Ноя 2019 |
{period_string} | с 26 Ноя до 27 Ноя 2019 |
{created_at}, {unsubscribed_at} | Вт 26 Ноя 2019 |
Все указанные переменные поддерживают настройки форматирования даты и времени.
Для того чтобы изменить формат, необходимо добавить параметр format="", например{today format="d.m.y"}
Примеры популярных шаблонов параметра «format»:
| Шаблон | Пример использования | Пример вывода |
format="d.m.Y" | {today format="d.m.Y"} | 26.11.2019 |
format="j f Y года" | {today format="j f Y года"} | 26 ноября 2019 года |
format="l, j f" | {today format="l, j f"} | Вторник, 26 ноября |
format="j f (l) в 19-00 | {today format="j f (l) в 19-00"} | 26 ноября (Вторник) в 19-00 |
format="j f Y года в H:i" | {deal.created_at_datetime format="j f Y года в H:i"} | 26 ноября 2019 года в 18:00 |
Обратите внимание
Если в шаблоне параметра format встречается определенный символ (символы), то они заменяются на день, месяц или год (и т. п.) в зависимости от выводимой даты.
Например, для того чтобы вывести дату в виде «9 июня 2020 года», нужно задать шаблон форматирования в виде «j f Y года»:
- символ «j» будет заменен на день месяца без ведущего нуля (от 1 до 31);
- символы «f» — на название месяца на русском языке в родительном падеже;
- символ «Y» — на четыре цифры порядкового номера года;
- слово «года» и пробелы останутся без изменений.
То есть если в шаблоне встречаются особые символы, они заменяются на параметры из даты. Остальные символы выводятся без изменения.
Другие переменные, поддерживающие форматирование дат:
По пользователям:
{created_at} — Дата регистрации.
{unsubscribed_at} — Дата отписки от рассылки.
По заказам:
{deal.created_at} — Дата создания заказа (только для рассылок и API).{deal.payed_at} — Дата оплаты заказа (только для рассылок и API).{deal.created_at_datetime} — Дата и время создания заказа (только для рассылок).{deal.payed_at_datetime} — Дата и время оплаты заказа (только для рассылок).
По покупкам:
{start_at} — Дата начала.{finish_at} — Дата окончания.{period_string} — Период доступа.
Подробнее об использовании этих переменных можно узнать в статье блога «Переменные в рассылках и на страницах сайта».
Подробное описание символов в параметре format
Важно
Если значение переменной не содержит время (только дату) и в параметре format используются символы для вывода времени, то они будут заменены на нули.
| Символ в строке format | Описание | Пример возвращаемого значения |
| День | ||
| d | День месяца, 2 цифры с ведущим нулём | от 01 до 31 |
| D | Текстовое представление дня недели, 2 символа | от Пн до Вс |
| j | День месяца без ведущего нуля | от 1 до 31 |
| l (строчная ’L’) | Полное наименование дня недели | от Понедельник до Воскресенье |
| N | Порядковый номер дня недели | от 1 (понедельник) до 7 (воскресенье) |
| S | Английский суффикс порядкового числительного дня месяца, 2 символа | st, nd, rd и т.д. |
| w | Порядковый номер дня недели (начиная с 0) | от 0 (воскресенье) до 6 (суббота) |
| z | Порядковый номер дня в году (начиная с 0) | от 0 до 365 |
| W | Порядковый номер недели года, недели начинаются с понедельника. Если год (пример 1 января 2020 года) начался со среды, то это будет считаться 1 неделя года | Например: 42 (42-я неделя года) |
| Месяц | ||
| FFF | Полное наименование месяца в именительном падеже с большой буквы | от Январь до Декабрь |
| fff | Полное наименование месяца в именительном падеже с маленькой буквы | от январь до декабрь |
| F | Полное наименование месяца с большой буквы | от Января до Декабря |
| f | Полное наименование месяца с маленькой буквы | от января до декабря |
| m | Порядковый номер месяца с ведущим нулём | от 01 до 12 |
| M | Сокращенное наименование месяца, 3 символа | от Янв до Дек |
| n | Порядковый номер месяца без ведущего нуля | от 1 до 12 |
| t | Количество дней в месяце | от 28 до 31 |
| Год | ||
| Y | Порядковый номер года, 4 цифры | Примеры: 1999, 2003 |
| y | Номер года, 2 цифры | Примеры: 99, 03 |
| Время | ||
| a | Ante meridiem (лат. «до полудня») или Post meridiem (лат. «после полудня») в нижнем регистре | am или pm |
| A | Ante meridiem или Post meridiem в верхнем регистре | AM или PM |
| B | Время в формате Интернет-времени (альтернативной системы отсчета времени суток) | от 000 до 999 |
| g | Часы в 12-часовом формате без ведущего нуля | от 1 до 12 |
| G | Часы в 24-часовом формате без ведущего нуля | от 0 до 23 |
| h | Часы в 12-часовом формате с ведущим нулём | от 01 до 12 |
| H | Часы в 24-часовом формате с ведущим нулём | от 00 до 23 |
| i | Минуты с ведущим нулём | от 00 до 59 |
| s | Секунды с ведущим нулём | от 00 до 59 |
Особое форматирование переменных today plus и nextweekday
Если при использовании переменной today plus необходим формат «dd.mm (полностью)», добавьте format="auto" к переменной.
Например, {today plus="4" format="auto"}
Если необходимо, чтобы выводилось слово «завтра», используйте следующую переменную {today plus="1" format="auto"}.
Переменные
Значения переменных
Если при использовании переменной nextweekday необходим формат «dd.mm (полностью)», добавьте format="auto" к переменной.
Если необходимо, чтобы выводилось слово «сегодня», используйте переменную {nextweekday day="Tuesday" today="yes" format="auto"}.
Переменные
Значения переменных
