ExcelScript.NumberFormatCategory enum

Stellt eine Kategorie von Zahlenformaten dar.

Hinweise

Beispiele

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

Felder

accounting

Buchhaltungsformate weisen die Währungssymbole und Dezimalstellen in einer Spalte auf.

currency

Währungsformate werden für allgemeine Währungswerte verwendet. Verwenden Sie Buchhaltungsformate, um Dezimalstellen in einer Spalte auszurichten.

custom

Ein benutzerdefiniertes Format, das nicht Teil einer Kategorie ist.

date

Datumsformate zeigen Datums- und Uhrzeitnummern als Datumswerte an. Datumsformate, die mit einem Sternchen (*) beginnen, reagieren auf Änderungen an regionalen Datums- und Uhrzeiteinstellungen, die für das Betriebssystem angegeben sind. Formate ohne Sternchen sind von den Betriebssystemeinstellungen nicht betroffen.

fraction

Bruchformate zeigen den Zellwert als ganze Zahl an, wobei der Rest auf den nächsten Bruchwert gerundet wird.

general

Zellen im allgemeinen Format haben kein bestimmtes Zahlenformat.

number

Number wird für die allgemeine Anzeige von Zahlen verwendet. Währung und Buchhaltung bieten spezielle Formatierungen für den Geldwert.

percentage

Prozentformate multiplizieren den Zellwert mit 100 und zeigen das Ergebnis mit einem Prozentsymbol an.

scientific

Wissenschaftliche Formate zeigen den Zellwert als Zahl zwischen 1 und 10 multipliziert mit einer Potenz von 10 an.

special

Spezielle Formate sind nützlich für die Nachverfolgung von Listen- und Datenbankwerten.

text

Textformatzellen werden auch dann als Text behandelt, wenn sich eine Zahl in der Zelle befindet. Die Zelle wird genau wie eingegeben angezeigt.

time

Zeitformate zeigen Datums- und Uhrzeitseriennummern als Datumswerte an. Zeitformate, die mit einem Sternchen (*) beginnen, reagieren auf Änderungen in regionalen Datums- und Uhrzeiteinstellungen, die für das Betriebssystem angegeben sind. Formate ohne Sternchen sind von den Betriebssystemeinstellungen nicht betroffen.