ExcelScript.NumberFormatCategory enum

Представляет категорию числовых форматов.

Комментарии

Примеры

/**
 * This script finds cells in a table column that are not formatted as currency
 * and sets the fill color to red.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the "Cost" column from the "Expenses" table.
  const table = workbook.getTable("Expenses");
  const costColumn = table.getColumnByName("Cost");
  const costColumnRange = costColumn.getRangeBetweenHeaderAndTotal();

  // Get the number format categories for the column's range.
  const numberFormatCategories = costColumnRange.getNumberFormatCategories();

  // If any cell in the column doesn't have a currency format, make the cell red.
  numberFormatCategories.forEach((category, index) =>{
    if (category[0] != ExcelScript.NumberFormatCategory.currency) {
      costColumnRange.getCell(index, 0).getFormat().getFill().setColor("red");
    }
  }); 
}

Поля

accounting

Форматы учета выстраивает символы валют и десятичные точки в столбце.

currency

Денежные форматы используются для общих денежных значений. Используйте форматы учета для выравнивания десятичных точек в столбце.

custom

Пользовательский формат, который не является частью какой-либо категории.

date

Форматы даты отображают серийные номера даты и времени в качестве значений даты. Форматы даты, начинающиеся со звездочки (*), реагируют на изменения региональных параметров даты и времени, указанных для операционной системы. На форматы без звездочки параметры операционной системы не влияют.

fraction

Форматы дроби отображают значение ячейки в виде целого числа с округлением до ближайшего значения дроби.

general

Ячейки общего формата не имеют определенного числового формата.

number

Число используется для общего отображения чисел. Валюта и бухгалтерия предлагают специализированное форматирование для денежной стоимости.

percentage

Процентные форматы умножают значение ячейки на 100 и отображают результат с символом процента.

scientific

В научных форматах значение ячейки отображается в виде числа от 1 до 10, умноженного на 10.

special

Специальные форматы полезны для отслеживания значений списка и базы данных.

text

Ячейки форматирования текста обрабатываются как текст, даже если в ячейке находится число. Ячейка отображается точно так, как введено.

time

В форматах времени в качестве значений даты отображаются серийные номера даты и времени. Форматы времени, начинающиеся со звездочки (*), реагируют на изменения региональных параметров даты и времени, указанных для операционной системы. На форматы без звездочки параметры операционной системы не влияют.