Share via


ExcelScript.NumberFormatCategory enum

Representa uma categoria de formatos de número.

Comentários

Exemplos

/**
 * 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");
    }
  }); 
}

Campos

accounting

Os formatos de contabilidade alinham os símbolos de moeda e os pontos decimal em uma coluna.

currency

Conversor de Moedas formatos são usados para valores monetários gerais. Use formatos de contabilidade para alinhar pontos decimais em uma coluna.

custom

Um formato personalizado que não faz parte de nenhuma categoria.

date

Os formatos de data exibem números de série de data e hora como valores de data. Os formatos de data que começam com um asterisco (*) respondem a alterações nas configurações regionais de data e hora especificadas para o sistema operacional. Os formatos sem um asterisco não são afetados pelas configurações do sistema operacional.

fraction

Os formatos de fração exibem o valor da célula como um número inteiro com o restante arredondado para o valor de fração mais próximo.

general

As células de formato geral não têm um formato de número específico.

number

O número é usado para exibição geral de números. Conversor de Moedas e a contabilidade oferecem formatação especializada para valor monetário.

percentage

Formatos percentuais multiplicam o valor da célula por 100 e exibem o resultado com um símbolo percentual.

scientific

Formatos científicos exibem o valor da célula como um número entre 1 e 10 multiplicado por uma potência de 10.

special

Formatos especiais são úteis para acompanhar valores de lista e banco de dados.

text

As células de formato de texto são tratadas como texto mesmo quando um número está na célula. A célula é exibida exatamente como inserida.

time

Os formatos de hora exibem números de série de data e hora como valores de data. Os formatos de tempo que começam com um asterisco (*) respondem a alterações nas configurações de data e hora regionais especificadas para o sistema operacional. Os formatos sem um asterisco não são afetados pelas configurações do sistema operacional.