---
metadata:
- name: generator
content: Diplodoc Platform v5.70.0
alternate:
- https://yandex.ru/support/kit/ru/site-editor/custom-sections/utilities/inline-helpers/formatting.md
- href: https://yandex.ru/support/kit/ru/site-editor/custom-sections/utilities/inline-helpers/formatting.md
type: text/markdown
title: Markdown version
- href: https://yandex.ru/support/kit/ru/llms.txt?revision=r22105010
rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/kit/ru/llms.txt?revision=r22105010
# Работа с форматированием
### formatDate {#formatDate}
#|
|| **Описание** | **Сигнатура** ||
|| Форматирует дату в локальном часовом поясе среды выполнения. Числовой timestamp задается в миллисекундах. Некорректная дата вызывает ошибку.
Поддерживаемые токены:
* `YYYY`, `YY` — год; `MM`, `M` — месяц.
* `DD`, `D` — день; `HH`, `H` — часы.
* `mm`, `m` — минуты; `ss`, `s` — секунды.
* `SSS`, `SS`, `S` — миллисекунды с точностью до 1, 10 и 100 мс соответственно.
Двойные токены дополняются ведущим нулем. Названия месяцев (`MMMM`) не поддерживаются. | `{{formatDate date format}}` ||
|#
{% cut "Параметры" %}
#|
|| **Параметр** | **Тип** | **Описание** ||
|| `date` | Date, String, Number | Объект Date, строка даты или timestamp в миллисекундах. ||
|| `format` | String | Строка формата. ||
|#
{% endcut %}
{% cut "Примеры" %}
```handlebars
{{!-- Данные: { createdAt: "2024-03-15T14:30:00" } --}}
{{formatDate createdAt "DD.MM.YYYY"}}
{{!-- Результат: "15.03.2024" --}}
{{formatDate createdAt "DD.MM.YYYY"}}
{{!-- Результат: "15.03.2024" --}}
{{formatDate createdAt "DD.MM.YYYY HH:mm"}}
{{!-- Результат: "15.03.2024 14:30" --}}
{{formatDate createdAt "HH:mm:ss"}}
{{!-- Результат: "14:30:00" --}}
```
{% endcut %}
### formatLineBreaks {#formatLineBreaks}
#|
|| **Описание** | **Сигнатура** ||
|| Преобразует переносы строк (`\n`) в элементы `
`. Возвращает React-элементы для отображения текста с переносами, а не HTML-строку.
HTML внутри исходного текста не исполняется. | `{{formatLineBreaks text}}` ||
|#
{% cut "Параметры" %}
#|
|| **Параметр** | **Тип** | **Описание** ||
|| `text` | String | Текст с символами переноса строки (`\n`). ||
|#
{% endcut %}
{% cut "Примеры" %}
```handlebars
{{!-- Данные: { description: "Первая строка\nВторая строка\nТретья строка" } --}}
{{formatLineBreaks description}}
{{!-- HTML при рендеринге: Первая строка
Вторая строка
Третья строка --}}
```
{% endcut %}
### formatPhoneNumber {#formatPhoneNumber}
#|
|| **Описание** | **Сигнатура** ||
|| Форматирует номер телефона в читаемый вид. | `{{formatPhoneNumber phone}}` ||
|#
{% cut "Параметры" %}
#|
|| **Параметр** | **Тип** | **Описание** ||
|| `phone` | String | Номер телефона. ||
|#
{% endcut %}
{% cut "Примеры" %}
```handlebars
{{!-- Данные: { phone: "79001234567" } --}}
{{formatPhoneNumber phone}}
{{!-- Результат: "8 (900) 123-45-67" --}}
{{formatPhoneNumber "88001234567"}}
{{!-- Результат: "8 (800) 123-45-67" --}}
```
{% endcut %}
### formatPrice {#formatPrice}
#|
|| **Описание** | **Сигнатура** ||
|| Форматирует число как цену с разделителями разрядов и символом валюты:
* Для рублей используются неразрывные пробелы; целая сумма выводится без копеек.
* Для `USD` и `EUR` используется формат `en-US` с двумя знаками после точки. | `{{formatPrice value currency}}` ||
|#
{% cut "Параметры" %}
#|
|| **Параметр** | **Тип** | **Описание** ||
|| `value` | Number, String | Число или числовая строка с ценой. ||
|| `currency` | String | Код валюты: `RUB`, `USD` или `EUR` (необязательный, по умолчанию `RUB`) ||
|#
{% endcut %}
{% cut "Примеры" %}
```handlebars
{{!-- Данные: { price: 1499.9, oldPrice: 2999, shipping: 0 } --}}
{{formatPrice price}}
{{!-- Результат: "1 499,90 ₽" --}}
{{formatPrice oldPrice}}
{{!-- Результат: "2 999 ₽" --}}
{{formatPrice price "USD"}}
{{!-- Результат: "$1,499.90" --}}
```
{% endcut %}
### pluralize {#pluralize}
#|
|| **Описание** | **Сигнатура** ||
|| Возвращает форму слова в зависимости от числа. В выбранной форме заменяет все вхождения `%d` на переданное число.
Приведенные правила выбора формы рассчитаны на неотрицательные целые числа. | `{{pluralize count one few many}}` ||
|#
{% cut "Параметры" %}
#|
|| **Параметр** | **Тип** | **Описание** ||
|| `count` | Number | Первое значение. ||
|| `one` | String| Форма для 1 (1 **товар**). ||
|| `few` | String | Форма для 2–4 (3 **товара**). ||
|| `many` | String | Форма для 5–20, 0 (5 **товаров**). ||
|#
{% endcut %}
{% cut "Правила выбора формы" %}
#|
|| **count** | **Окончание** | **Форма** | **Пример** ||
|| 1 | `one` | 1-я | 1 **товар**. ||
|| 2-4 | `few` | 2-я | 3 **товара**. ||
|| 5-20 | `many` | 3-я | 5 **товаров**. ||
|| 21 | `one` | 1-я | 21 **товар**. ||
|| 22-24 | `few` | 2-я | 22 **товара**. ||
|| 25-30 | `many` | 3-я | 25 **товаров**. ||
|| 111-119 | `many` | 3-я | 111 **товаров**. ||
|#
{% endcut %}
{% cut "Примеры" %}
```handlebars
5 {{pluralize 5 "товар" "товара" "товаров"}}
{{!-- Результат: "5 товаров" --}}
1 {{pluralize 1 "товар" "товара" "товаров"}}
{{!-- Результат: "1 товар" --}}
3 {{pluralize 3 "товар" "товара" "товаров"}}
{{!-- Результат: "3 товара" --}}
21 {{pluralize 21 "товар" "товара" "товаров"}}
{{!-- Результат: "21 товар" --}}
0 {{pluralize 0 "товар" "товара" "товаров"}}
{{!-- Результат: "0 товаров" --}}
```
{% endcut %}
## Обратиться в службу поддержки
[Написать в чат](https://yandex.ru/chat/#/user/6c041b05-07a4-99cc-79be-8670b7aff93d){.button}
[Написать письмо](https://yandex.ru/support/kit/ru/feedback.md){.button}
[Яндекс KITᵝ в Telegram](https://t.me/kityandex_support_bot){.button}
[Яндекс KITᵝ в МАКС](https://max.ru/yandex_kit_bot){.button}