ExcelScript.NumberFormatCategory enum

Paquet:

ExcelScript

Représente une catégorie de formats numériques.

Remarques

Exemples

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

Champs

accounting	Les formats de comptabilité alignent les symboles monétaires et les décimales dans une colonne.
currency	Les formats monétaires sont utilisés pour les valeurs monétaires générales. Utilisez les formats de comptabilité pour aligner des virgules décimales dans une colonne.
custom	Format personnalisé qui ne fait partie d’aucune catégorie.
date	Les formats de date affichent les numéros de série de date et d’heure sous forme de valeurs de date. Les formats de date commençant par un astérisque (*) répondent aux modifications apportées aux paramètres régionaux de date et d’heure spécifiés pour le système d’exploitation. Les formats sans astérisque ne sont pas affectés par les paramètres du système d’exploitation.
fraction	Les formats de fraction affichent la valeur de cellule sous la forme d’un nombre entier, le reste étant arrondi à la valeur de fraction la plus proche.
general	Les cellules de format général n’ont pas de format numérique spécifique.
number	Number est utilisé pour l’affichage général des nombres. La devise et la comptabilité offrent une mise en forme spécialisée pour la valeur monétaire.
percentage	Les formats de pourcentage multiplient la valeur de cellule par 100 et affichent le résultat avec un symbole de pourcentage.
scientific	Les formats scientifiques affichent la valeur de cellule sous la forme d’un nombre compris entre 1 et 10 multiplié par une puissance de 10.
special	Les formats spéciaux sont utiles pour le suivi des valeurs de liste et de base de données.
text	Les cellules de format de texte sont traitées comme du texte même lorsqu’un nombre se trouve dans la cellule. La cellule s’affiche exactement comme entré.
time	Les formats d’heure affichent les numéros de série de date et d’heure sous forme de valeurs de date. Les formats d’heure qui commencent par un astérisque (*) répondent aux modifications apportées aux paramètres régionaux de date et d’heure spécifiés pour le système d’exploitation. Les formats sans astérisque ne sont pas affectés par les paramètres du système d’exploitation.