# 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`        | Воскресенье следующей недели     |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.leadconverter.su/funkcii/data-i-vremya/date_calc.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.