numberFormat

await crafttechApi.numberFormat(fileHandler, sheetName, range, flag);

Описание

Устанавливает формат ячейки (или диапазона ячеек) по переданному шаблону. Содержимое ячейки должно быть числом.

Аналог SetNumberFormat в Р7-Офис, но работает с внешними файлами.

Параметры

• fileHandler (number) — ссылка на файл; ссылку предоставляет метод openFile;
• sheetName (string) — название листа;
• range (string) — диапазон ячеек;
• flag (string) — формат отображения значения в ячейке. Поддерживаются следующие флаги:
  • '@' — преобразование значения в текст.
  • '0' — округление числа до целого.
  • '0.00' — отображение числа с двумя знаками после запятой.
  • '#,##0' — отображение числа с разделением тысяч пробелами (например, 1234567 → 1 234 567).
  • '#,##0.00' — отображение числа с разделением тысяч пробелами и двумя знаками после запятой.
  • '0%' — отображение значения в виде процента без знаков после запятой.
  • '0.00%' — отображение значения в виде процента с двумя знаками после запятой.
  • '0.00E+00' — отображение значения в экспоненциальной (научной) форме.
  • '# ?/?' — отображение числа в виде простой дроби.
  • '# ??/??' — отображение числа в виде дроби с выравниванием.
  • 'mm-dd-yy' — отображение даты в формате месяц-день-год (например, 12-31-25).
  • 'd-mmm-yy' — отображение даты с сокращённым названием месяца (например, 5-янв-25).
  • 'd-mmm' — отображение только дня и сокращённого месяца.
  • 'mmm-yy' — отображение месяца и года.
  • 'h:mm AM/PM' — отображение времени в 12-часовом формате с AM/PM.
  • 'h:mm:ss AM/PM' — отображение времени с секундами и AM/PM.
  • 'h:mm' — отображение времени в 24-часовом формате.
  • 'h:mm:ss' — отображение времени с секундами.
  • 'm/d/yy h:mm' — отображение даты и времени.
  • '#,##0 ;(#,##0)' — отображение положительных и отрицательных чисел в формате с разделением тысяч запятыми, отрицательные числа отображаются в скобках.
  • '#,##0.00;(#,##0.00)' — как выше, но с двумя знаками после точки.
  • 'mm:ss' — отображение времени в формате минуты:секунды.
  • '[h]:mm:ss' — отображение продолжительности времени, включая часы свыше 24.
  • 'mmss.0' — отображение времени в виде минут и секунд с одной десятичной.
  • '##0.0E+0' — отображение в научной нотации с одним десятичным знаком.
  • 'dd/mm/yyyy;@' — наложение маски на ячейку для корректного отображения даты в формате, используемом в Р7-Офисе.

Возвращает

• true | false (boolean) — логическая истина true в случае успешного преобразования числа.

Пример

const result = await crafttechApi.numberFormat(
  fileHandler,
  "Лист1",
  "A1:A3",
  "# ##0,00"
);
console.log("Преобразование чисел: ", result);