> For the complete documentation index, see [llms.txt](https://docs.leadconverter.su/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.leadconverter.su/funkcii/data-i-vremya/date_calc.md).

# date\_calc

Формат записи следующий:

\[date\_calc]Формат даты|модификатор|значение даты\[/date\_calc]

`[date_calc]%d.%m.%Y %H:%M:%S|+1 day[/date_calc]`

### Аргументы

Функция принимает 3 **аргумента** (разделяются символом `|`):

1. **Формат (обязательный)**\
   Указывает, в каком виде будет возвращена дата.\
   Используются [плейсхолдеры, предоставленные в таблице ниже.](#format-zapisi-vremeni)\
   Также можно указать `timestamp`, `ts`, `unix` или `unixtime` — тогда результатом будет число секунд в формате Unix-времени.\
   \
   Популярные варианты значений: 

| Модидфикаторы             | Формат                                                         | Назначение                                                                                                                             |
| ------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| %d.%m.%Y %H:%M:%S         | <p>дд.мм.уууу чч:мм <br>например:<br>30.01.2028 12:34:56</p>   | Стандартная дата в Европейском формате                                                                                                 |
| %Y-%m-%dT%H:%M:%S         | <p>гггг-мм-ддTчч:мм:сс<br>например:<br>2028-01-30T12:34:56</p> | <p>Международный стандарт ISO 8601<br>Чаще всего используется в API</p>                                                                |
| ts или timestamp или unix | <p>unixtime<br>например:<br>1832837696</p>                     | <p><a href="https://ru.wikipedia.org/wiki/Unix-%D0%B2%D1%80%D0%B5%D0%BC%D1%8F">Unix timestamp</a><br>Чаще всего используется в API</p> |

2. **Модификатор (необязательный)**\
   Определяет, какие действия нужно провести с датой.\
   Запись вида:

* `+1 day` → прибавить 1 день
* `-2 hours` → вычесть 2 часа
* `+3 months` → прибавить 3 месяца

Могут использоваться совместно, например запись: \
\[date\_calc]%d.%m.%Y %H:%M:%S|+1 day -1 hour +15 minutes\[/date\_calc]\
Добавит 23 часа и 15 минут к текущей дате

3. **Текущее значение (необязательный)**\
   От какой даты вести расчёт.\
   По умолчанию — текущая дата и время.\
   Можно передавать:

* **Unix timestamp** — например: `1739с798100`
* **Европейский формат** — `17.02.2025`
* **Американский формат** — `2025-02-17`
* [**Читабельные выражения на английском языке**](#primery-chitabelnykh-vyrazhenii)

{% hint style="info" %}
Все аргументы поддерживают вставку переменных
{% endhint %}

{% hint style="success" %}
Если остались вопросы, всегда можно задать вопрос в техподдержку или в чат поддержки, всегда поможем :)
{% endhint %}

{% content-ref url="/pages/-MasAPNcg291uNezFqb4" %}
[Как задать вопрос в поддержку?](/kak-zadat-vopros-v-podderzhku.md)
{% endcontent-ref %}

### **Формат записи времени**

### **День**

<table><thead><tr><th width="150">Формат</th><th width="216.7526575373732">Описание</th><th>Результат примера</th></tr></thead><tbody><tr><td>%a</td><td>Сокращённое название дня недели</td><td>Сб</td></tr><tr><td>%A</td><td>Полное название дня недели</td><td>Суббота</td></tr><tr><td>%d</td><td>Двухзначное представление дня месяца (с ведущими нулями)</td><td>29 (От <code>01</code> до <code>31)</code></td></tr><tr><td>%e</td><td>День месяца, с ведущим пробелом, если он состоит из одной цифры.</td><td>1 (От <code>1</code> до <code>31</code>)</td></tr><tr><td>%j</td><td>Порядковый номер в году, 3 цифры с ведущими нулями</td><td>029 (От <code>001</code> до <code>366</code>)</td></tr><tr><td>%u</td><td>Порядковый номер дня недели согласно стандарту ISO-8601</td><td>6 (От <code>1</code> (понедельник) до <code>7</code> (воскресенье))</td></tr><tr><td>%w</td><td>Порядковый номер дня недели</td><td>6 (От <code>0</code> (воскресенье) до <code>6</code> (суббота))</td></tr></tbody></table>

### **Неделя**

<table data-header-hidden><thead><tr><th width="152.1494179292613"></th><th width="341.9543803046395"></th><th></th></tr></thead><tbody><tr><td>%U</td><td>Порядковый номер недели в указанном году, начиная с первого воскресенья в качестве первой недели</td><td><code>13</code> (для полной 13-й недели года)</td></tr><tr><td>%V</td><td>Порядковый номер недели в указанном году в соответствии со стандартом ISO-8601:1988, счёт начинается с той недели, которая содержит минимум 4 дня, неделя начинается с понедельника</td><td>От <code>01</code> до <code>53</code> (где 53 указывает на перекрывающуюся неделю)</td></tr><tr><td>%W</td><td>Порядковый номер недели в указанном году, начиная с первого понедельника в качестве первой недели</td><td><code>46</code> (для 46-й недели года, начинающейся с понедельника)</td></tr></tbody></table>

### **Месяц**

<table data-header-hidden><thead><tr><th width="150"></th><th width="367.3304056880214"></th><th></th></tr></thead><tbody><tr><td><strong>%</strong>b</td><td>Аббревиатура названия месяца, в соответствии с настройками локали</td><td>От <code>Янв</code> до <code>Дек</code></td></tr><tr><td>%B</td><td>Полное название месяца, в соответствии с настройками локали</td><td>От <code>Января</code> до <code>Декабря</code></td></tr><tr><td>%h</td><td>Аббревиатура названия месяца, в соответствии с настройками локали (псевдоним %b)</td><td>От <code>Янв</code> до <code>Дек</code></td></tr><tr><td>%m</td><td>Двухзначный порядковый номер месяца</td><td>От <code>01</code> (январь) до <code>12</code> (декабрь)</td></tr></tbody></table>

### Год

<table data-header-hidden><thead><tr><th width="150"></th><th width="382.71827679865714"></th><th></th></tr></thead><tbody><tr><td>%C</td><td>Двухзначный порядковый номер столетия (год, делённый на 100, усечённый до целого)</td><td><code>19</code> для 20-го века</td></tr><tr><td>%g</td><td>Двухзначный номер года в соответствии со стандартом ISO-8601:1988 (смотрите %V)</td><td>Пример: <code>09</code> для недели 6 января 2009</td></tr><tr><td>%G</td><td>Полная четырёхзначная версия %g</td><td>Пример: <code>2009</code> для недели 3 января 2009</td></tr><tr><td>%y</td><td>Двухзначный порядковый номер года</td><td>Пример: <code>09</code> для 2009, <code>79</code> для 1979</td></tr><tr><td>%Y</td><td>Четырёхзначный номер года</td><td>Пример: <code>2038</code></td></tr></tbody></table>

### **Время**

<table data-header-hidden><thead><tr><th width="157.33333333333331"></th><th width="341.42105263157896"></th><th></th></tr></thead><tbody><tr><td>%H</td><td>Двухзначный номер часа в 24-часовом формате</td><td>От <code>00</code> до <code>23</code></td></tr><tr><td>%k</td><td>Часы в 24-часовом формате, с пробелом перед одиночной цифрой</td><td>От <code>0</code> до <code>23</code></td></tr><tr><td>%I</td><td>Двухзначный номер часа в 12-часовом формате</td><td>От <code>01</code> до <code>12</code></td></tr><tr><td>%l (строчная 'L')</td><td>Час в 12-часовом формате, с пробелом перед одиночной цифрой</td><td>От <code>1</code> до <code>12</code></td></tr><tr><td>%M</td><td>Двухзначный номер минуты</td><td>От <code>00</code> до <code>59</code></td></tr><tr><td>%p</td><td>'AM' или 'PM' в верхнем регистре, в зависимости от указанного времени</td><td>Пример: <code>AM</code> для 00:31, <code>PM</code> для 22:23</td></tr><tr><td>%P</td><td>'am' или 'pm' в зависимости от указанного времени</td><td>Пример: <code>am</code> для 00:31, <code>pm</code> для 22:23</td></tr><tr><td>%r</td><td>То же что и "%I:%M:%S %p"</td><td>Пример: <code>09:34:17 PM</code> для 21:34:17</td></tr><tr><td>%R</td><td>То же что и "%H:%M"</td><td>Пример: <code>00:35</code> для 12:35 AM, <code>16:44</code> для 4:44 PM</td></tr><tr><td>%S</td><td>Двухзначный номер секунды</td><td>От <code>00</code> до <code>59</code></td></tr><tr><td>%T</td><td>То же что и "%H:%M:%S"</td><td>Пример: <code>21:34:17</code> для 09:34:17 PM</td></tr><tr><td>%X</td><td>Предпочитаемое отображение времени в зависимости от локали, без даты</td><td>Пример: <code>03:59:16</code> или <code>15:59:16</code></td></tr><tr><td>%z</td><td>Смещение часового пояса относительно UTC. Не реализовано в Windows, подробности смотрите ниже.</td><td>Пример: <code>-0500</code> для US Eastern Time</td></tr><tr><td>%Z</td><td>Аббревиатура часового пояса.</td><td>Пример: <code>EST</code> для Eastern Time</td></tr></tbody></table>

### **Сложение и вычитание времени**

### **Сложение**

*n = любое число, которое нужно указать, чтобы функция отрабатывала корректно*

<table><thead><tr><th width="150">Значение</th><th width="197.7744762803461">Пример</th><th>Пояснение</th></tr></thead><tbody><tr><td>+<strong>n</strong> hours</td><td><strong>[date_calc]</strong>%H|+1 hours<strong>[/date_calc]</strong></td><td>Прибавление к текущей дате + 1 час<br><br></td></tr><tr><td>+<strong>n</strong> day</td><td><strong>[date_calc]</strong>%d.%m|+1 day<strong>[/date_calc]</strong></td><td>Прибавление к текущей дате + 1 день</td></tr><tr><td>+<strong>n</strong> week</td><td><strong>[date_calc]</strong>%d.%m|+1 week<strong>[/date_calc]</strong></td><td>Прибавление к текущей дате + 1 неделя</td></tr><tr><td>+<strong>n</strong> month</td><td><strong>[date_calc]</strong>%d.%m|+1 month<strong>[/date_calc]</strong></td><td>Прибавление к текущей дате + 1 месяц</td></tr><tr><td>+<strong>n</strong> years</td><td><strong>[date_calc]</strong>%d.%m.%Y|+1 years<strong>[/date_calc]</strong></td><td>Прибавление к текущей дате + 1 год</td></tr></tbody></table>

### **Вычитание**

<table><thead><tr><th width="150">Значение</th><th width="222.7744762803461">Пример</th><th>Пояснение</th></tr></thead><tbody><tr><td><strong>-n</strong> hours</td><td><strong>[date_calc]</strong>%H|-1 hours<strong>[/date_calc]</strong></td><td>Вычитание от текущей даты - 1 час<br><br></td></tr><tr><td><strong>-n</strong> day</td><td><strong>[date_calc]</strong>%d.%m|-1 day<strong>[/date_calc]</strong></td><td>Вычитание от текущей даты - 1 день</td></tr><tr><td><strong>-n</strong> week</td><td><strong>[date_calc]</strong>%d.%m|-1 week<strong>[/date_calc]</strong></td><td>Вычитание от текущей даты - 1 неделя</td></tr><tr><td><strong>-n</strong> month</td><td><strong>[date_calc]</strong>%d.%m|-1 month<strong>[/date_calc]</strong></td><td>Вычитание от текущей даты - 1 месяц</td></tr><tr><td><strong>-n</strong> years</td><td><strong>[date_calc]</strong>%d.%m.%Y|-1 years<strong>[/date_calc]</strong></td><td>Вычитание от текущей даты - 1 год</td></tr></tbody></table>

### Примеры читабельных выражений

| Пример                    | Что означает                     |
| ------------------------- | -------------------------------- |
| `now`                     | Текущий момент (по умолчанию)    |
| `yesterday`               | Вчера                            |
| `tomorrow`                | Завтра                           |
| `first day of this month` | Первый день текущего месяца      |
| `last day of this month`  | Последний день текущего месяца   |
| `first day of next month` | Первый день следующего месяца    |
| `last day of next month`  | Последний день следующего месяца |
| `monday this week`        | Понедельник текущей недели       |
| `sunday next week`        | Воскресенье следующей недели     |