Обычный текст
\r\nЖирный текст
\r\nПодчеркнутый текст
\r\nКурсивный текст
\r\nФиксированная ячейка G1
\r\n\r\nТекст красного цвета
\r\nКрасная заливка
\r\n\r\nФорматированное значение
\r\n\r\nЭтот текст не будет экспортирован
\r\n\r\nШирина столбца в котором находится ячейка 10
\r\n\r\nВысота строки в которой находится ячейка 50
\r\n\r\nТекст ячейки по центру
\r\n\r\nТекст ячейки по центру
\r\n\r\n\r\n Текст ячейки сверху по центру\r\n
\r\n\r\nТекст переносится внутри ячейки
\r\n\r\n| Колонка 1 | \r\nКолонка 2 | \r\nКолонка 3 | \r\n||
|---|---|---|---|---|
| Подколонка 3.1 | \r\nПодколонка 3.2 | \r\nПодколонка 3.3 | \r\n||
| Ячейка 1 | \r\nЯчейка 2 | \r\nЯчейка 3.1 | \r\nЯчейка 3.2 | \r\nЯчейка 3.3 | \r\n
`, также работают на `
` (кроме объединения).\r\n- Структура сохраняется, включая вложенные span внутри p.\r\n\r\n### Таблица стандартных форматов ячеек (numFmtId)\r\n\r\n| **numFmtId** | **Описание** | **Формат-код** |\r\n| ------------ | --------------------------------------------------- | -------------- |\r\n| 0 | Общий формат | `s` |\r\n| 1 | Целое число (0) | `null` |\r\n| 2 | Число (0.00) | `null` |\r\n| 3 | Число с разделителями (например, 1,000) | `null` |\r\n| 4 | Число с разделителями и двумя знаками после запятой | `null` |\r\n| 9 | Процент (0%) | `null` |\r\n| 10 | Процент с двумя знаками после запятой (0.00%) | `null` |\r\n| 11 | Экспоненциальный формат (0.00E+00) | `null` |\r\n| 14 | Дата (mm-dd-yy) | `d` |\r\n| 15 | Дата (d-mmm-yy) | `d` |\r\n| 16 | Дата (d-mmm) | `d` |\r\n| 17 | Дата (mmm-yy) | `d` |\r\n| 18 | Время (h:mm AM/PM) | `d` |\r\n| 19 | Время (h:mm:ss AM/PM) | `d` |\r\n| 20 | Время (h:mm) | `d` |\r\n| 21 | Время (h:mm:ss) | `d` |\r\n| 22 | Дата и время (m/d/yy h:mm) | `d` |\r\n| 49 | Текст (строка) | `s` |\r\n\r\n### Таблица типов ячеек\r\n\r\n| **Тип** | **Описание** |\r\n| ----------- | ---------------------------------------------------------------- |\r\n| `s` | Строка (обычный текст) |\r\n| `b` | Булево (True или False) |\r\n| `d` | Дата (например, формат даты \"mm-dd-yy\" или \"d-mmm-yy\") |\r\n| `e` | Ошибка (например, #DIV/0!) |\r\n| `inlineStr` | Встроенная строка (строка, заключённая непосредственно в ячейке) |\r\n| `str` | Строка (аналогично `s`, но используется для других типов строк) |\r\n| `n` | Число (по умолчанию используется для числовых значений) |\r\n| `null` | Число (если не указано иное, то ячейка считается числовой) |\r\n----\r\n\r\n# Руководство по пользовательским форматам чисел в Excel (Custom Number Formats)\r\n\r\nПользовательские форматы в Excel — это специальный синтаксис, который управляет **отображением значения**, не изменяя фактическое содержимое ячейки. Этот стандарт используется не только в Excel, но и в большинстве табличных редакторов и библиотек генерации файлов (например, SheetJS, ExcelJS).\r\n\r\n> **Важно:** В коде формата всегда используется **американский стандарт**:\r\n>\r\n> * Точка `.` — разделитель дробной части.\r\n> * Запятая `,` — разделитель тысяч.\r\n>\r\n> Excel автоматически заменит их на региональные символы при отображении (например, запятую и пробел для РФ).\r\n\r\n---\r\n\r\n## 1. Общая структура формата\r\n\r\nФормат может состоять из **одной** или **четырёх секций**, разделённых точкой с запятой `;`.\r\n\r\n**Синтаксис:**\r\n\r\n```\r\nПОЛОЖИТЕЛЬНЫЕ ; ОТРИЦАТЕЛЬНЫЕ ; НОЛЬ ; ТЕКСТ\r\n```\r\n\r\n**Пример:**\r\n\r\n```\r\n#,##0.00;[Red]-#,##0.00;\"-\";@\r\n```\r\n\r\n**Расшифровка:**\r\n\r\n1. **Положительные числа** — `#,##0.00` (разделители тысяч, 2 знака после запятой).\r\n2. **Отрицательные числа** — `[Red]-#,##0.00` (красный цвет и явный знак минус).\r\n3. **Ноль** — `\"-\"` (вместо 0 выводится прочерк).\r\n4. **Текст** — `@` (отображается без изменений).\r\n\r\n> Если указана **одна секция**, она применяется ко всем значениям.\r\n\r\n---\r\n\r\n## 2. Форматирование чисел\r\n\r\nБазовые символы для построения числовых форматов:\r\n\r\n| Символ | Назначение | Пояснение |\r\n| ------- | ---------------------- | ----------------------------------------------------------------------------------------------------- |\r\n| **`0`** | Обязательная цифра | Всегда отображается. Если цифры нет — выводится `0`. Полезно для фиксированной длины и дробной части. |\r\n| **`#`** | Необязательная цифра | Отображается только при наличии значащей цифры. Лишние нули скрываются. |\r\n| **`.`** | Десятичный разделитель | Отделяет целую часть от дробной. |\r\n| **`,`** | Разделитель тысяч | Включает группировку разрядов (обычно по 3 цифры). |\r\n\r\n### Примеры числовых форматов\r\n\r\n| Исходное значение | Код | Результат | Комментарий |\r\n| ----------------- | ----------- | ------------- | ------------------------------------- |\r\n| `1234.567` | `0` | **1235** | Округление до целого. |\r\n| `1234.567` | `0.00` | **1234.57** | Ровно 2 знака после запятой. |\r\n| `5.1` | `0.00` | **5.10** | Добавляет недостающий ноль. |\r\n| `0.5` | `#.##` | **.5** | Ведущий ноль скрыт. |\r\n| `1234567` | `#,##0` | **1 234 567** | Группировка тысяч. |\r\n| `1231.213` | `#,##0.000` | **1 231.213** | Тысячи + 3 знака дроби. |\r\n| `15` | `00000` | **00015** | Фиксированная длина (артикулы, коды). |\r\n\r\n---\r\n\r\n## 3. Даты и время\r\n\r\nВ Excel даты и время хранятся как **числа**, поэтому корректный формат критически важен для отображения.\r\n\r\n| Категория | Код | Описание | Пример (5 янв 2025) |\r\n| --------- | ---------- | ------------------------ | ------------------- |\r\n| **День** | `d` | День без ведущего нуля | 5 |\r\n| | `dd` | День с нулём | 05 |\r\n| | `ddd` | День недели (кратко) | Вс |\r\n| | `dddd` | День недели (полностью) | Воскресенье |\r\n| **Месяц** | `m` | Месяц без нуля | 1 |\r\n| | `mm` | Месяц с нулём | 01 |\r\n| | `mmm` | Название месяца (кратко) | янв |\r\n| | `mmmm` | Полное название месяца | Январь |\r\n| | `mmmmm` | Первая буква месяца | Я |\r\n| **Год** | `yy` | Год (2 цифры) | 25 |\r\n| | `yyyy` | Год (4 цифры) | 2025 |\r\n| **Время** | `h` / `hh` | Часы (0–23) | 9 / 09 |\r\n| | `m` / `mm` | Минуты* | 05 |\r\n| | `s` / `ss` | Секунды | 30 |\r\n\r\n> **Важно:** `m` используется и для месяцев, и для минут. Excel различает их **по контексту**:\r\n>\r\n> * рядом с `h` или `s` — минуты;\r\n> * в остальных случаях — месяц.\r\n\r\n### Примеры форматов дат\r\n\r\n| Код | Отображение |\r\n| --------------- | ------------------ |\r\n| `dd.mm.yyyy` | **05.01.2025** |\r\n| `d mmm yyyy` | **5 янв 2025** |\r\n| `mmmm yyyy` | **Январь 2025** |\r\n| `dd/mm/yy h:mm` | **05/01/25 15:30** |\r\n| `hh:mm:ss` | **15:30:45** |\r\n\r\n---\r\n\r\n## 4. Текст, единицы измерения и валюта\r\n\r\nДля добавления текста к числу используются:\r\n\r\n* двойные кавычки `\"текст\"`;\r\n* экранирование символов `\\`.\r\n\r\n| Формат | Значение | Результат |\r\n| ------------------- | -------- | -------------- |\r\n| `0 \"шт.\"` | 5 | **5 шт.** |\r\n| `0 \"руб.\"` | 100 | **100 руб.** |\r\n| `#,##0.00 [$€-407]` | 1500.5 | **1 500,50 €** |\r\n| `#,##0.00 [$₽-419]` | 1500.5 | **1 500,50 ₽** |\r\n| `\"№\" 000` | 25 | **№ 025** |\r\n\r\n---\r\n\r\n## 5. Проценты\r\n\r\nФормат процента автоматически умножает значение на 100.\r\n\r\n| Формат | Значение в ячейке | Результат |\r\n| ------- | ----------------- | ---------- |\r\n| `0%` | `0.15` | **15%** |\r\n| `0.00%` | `0.1567` | **15.67%** |\r\n\r\n---\r\n\r\n## 6. Цвета и условия\r\n\r\nЦвет задаётся в квадратных скобках в начале секции.\r\n\r\nДоступные базовые цвета:\r\n`[Black]`, `[Blue]`, `[Cyan]`, `[Green]`, `[Magenta]`, `[Red]`, `[White]`, `[Yellow]`.\r\n\r\n**Пример:**\r\n\r\n```\r\n[Green]#,##0;[Red]-#,##0\r\n```\r\n\r\n* Положительные значения — зелёные.\r\n* Отрицательные — красные.\r\n\r\n---\r\n\r\n## 7. Использование в HTML / JSON\r\n\r\nПри использовании форматов в HTML-атрибутах и JSON необходимо учитывать экранирование кавычек.\r\n\r\n### Общий шаблон\r\n\r\n```html\r\n
12500.5
\r\n```\r\n\r\n**2. Точное число (3 знака):**\r\n\r\n```html\r\n1231.213
\r\n```\r\n\r\n**3. Проценты:**\r\n\r\n```html\r\n0.15
\r\n```\r\n\r\n**Результат:** `15.00%`\r\n\r\n**4. Дата (ДД.ММ.ГГГГ):**\r\n\r\n```html\r\n2025-01-05
\r\n```\r\n\r\n**5. Единицы измерения:**\r\n\r\n```html\r\n5000
\r\n```\r\n\r\n> Обратите внимание на двойное экранирование кавычек внутри JSON-строки.\r\n\r\n## Лицензия\r\n\r\nСм. файл [LICENSE](./LICENSE).\r\n","readmeFilename":"README.md"}