Partager via


ExcelScript.NumberFormatCategory enum

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.