Переменные для вывода даты в рассылках и на страницах сайта

На платформе предоставлены следующие переменные для дат:

1. today — отображает текущую дату;
2. today plus — отображает дату, равную текущей дате плюс Х дней;
3. nextweekday — переменная выводит даты ближайшего указанного дня недели.

Форматирование вывода дат:

Особенности форматирования переменных today plus и nextweekday

Today

Переменная "today" выводит текущую дату в формате "дд.мм (полностью)".

Эта функция активна в рассылках для пользователей, заказов, покупок и на страницах сайта

Today plus

Переменная "today plus" отображает дату, равную текущей дате плюс Х дней, в формате "дд.мм.гггг".

Эта функция действует в рассылках для пользователей и на страницах сайта.

К переменной "today" добавлен необязательный атрибут "plus", который позволяет добавить указанное количество дней к текущей дате.

Пример:

26 ноября = 15.02.2019 26.12.2024 = 17.03.2019

Nextweekday

Переменная "nextweekday" выводит даты ближайшего указанного дня недели в формате "дд.мм.гггг".

Эта функция действует в рассылках для пользователей, заказов, покупок и на страницах сайта.

К переменной "nextweekday" добавлены атрибуты "day" и "today":

• "day" — обязательный параметр, указывающий название дня недели на английском языке;
• "today" — yes/no или 1/0, разрешение для сегодняшнего дня. Если "today" = yes, то проверка начинается с сегодняшнего дня, иначе — с завтрашнего.

Пример:

Допустим, сегодня 15.02.2019, и это пятница.

• 29.11.2024 = 22.02.2019
• 29.11.2024 = 15.02.2019
• 27.11.2024 = 20.02.2019

Соответствие дней недели:

• Monday — понедельник.
• Tuesday — вторник.
• Wednesday — среда.
• Thursday — четверг.
• Friday — пятница.
• Saturday — суббота.
• Sunday — воскресенье.

Если в шаблоне параметра format присутствует определенный символ (или символы), они будут заменены на соответствующий день, месяц или год, в зависимости от указанной даты.

Пример: чтобы отобразить дату в формате "9 июня 2020 года", нужно использовать шаблон форматирования "j f Y года":

• символ "j" заменится на число дня месяца без ведущего нуля (от 1 до 31);
• символы "f" заменятся на название месяца на русском языке в родительном падеже;
• символ "Y" заменится на четырехзначный год;
• слово "года" и пробелы останутся без изменений.

Таким образом, если в шаблоне встречаются особые символы, они автоматически заменяются на соответствующие параметры из даты, в то время как остальные символы выводятся без изменений.

Другие переменные, поддерживающие форматирование дат:

По пользователям:

— Дата регистрации.

— Дата отписки от рассылки.

По заказам:

{deal.created_at} — Дата создания заказа (только для рассылок).
{deal.payed_at} — Дата оплаты заказа (только для рассылок).
{deal.created_at_datetime} — Дата и время создания заказа (только для рассылок).
{deal.payed_at_datetime} — Дата и время оплаты заказа (только для рассылок).

По покупкам:

{start_at} — Дата начала.
{finish_at} — Дата окончания.
{period_string} — Период доступа.

Подробнее об использовании этих переменных можно узнать в статье блога «Переменные в рассылках и на страницах сайта».

Крайне важно отметить, что в случае, если значение переменной не включает в себя информацию о времени (а содержит только дату), и в параметре format присутствуют символы, предназначенные для отображения времени, эти символы будут заменены на нули.

Today plus

Если вам необходим формат «dd.mm (полностью)» при использовании переменной today plus, добавьте параметр format="auto" к этой переменной.

Пример использования: если вы хотите, чтобы было выведено слово «завтра», воспользуйтесь завтра.

Nextweekday

Если при использовании переменной nextweekday вам нужен формат «dd.mm (полностью)», добавьте параметр format="auto" к этой переменной.

Пример использования: если вы хотите, чтобы выводилось слово «сегодня», воспользуйтесь сегодня