1. IronXL
2. Comment faire
3. Définir les formats de données des cellules

Comment définir les formats de données des cellules

par Chaknith Bin

Le formatage des données et des nombres dans Excel vous permet de contrôler la manière dont les nombres, les dates, les heures et d'autres données sont affichés dans les cellules, ce qui améliore la lisibilité et garantit l'exactitude des données. Les formats de données permettent de présenter des informations dans des formats spécifiques tels que les pourcentages ou les devises. De même, les formats de nombres permettent de personnaliser les décimales et les options d'affichage.

La bibliothèque IronXL vous permet de définir le format des données ou des nombres en C#. Cette bibliothèque simplifie le processus de création, de formatage et de manipulation programmatique des fichiers Excel, ce qui en fait un outil précieux pour les tâches de traitement et de présentation des données dans les applications C#.

Commencez avec IronXL

Commencez à utiliser IronXL dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :

Commencer gratuitement

Définir les formats de données des cellules Exemple

La propriété FormatString est accessible à la fois par les cellules et les plages. Il est donc possible de définir des formats de données pour des cellules individuelles, des colonnes, des lignes et toute plage sélectionnée.

:path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format.cs

using IronXL;
using IronXL.Formatting;
using System;
using System.Linq;

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set the data format to 12300.00%
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Percent2;

// Set the data format to 123.0000
workSheet["A2"].Value = 123;
workSheet["A2"].FormatString = "0.0000";

// Set data display format to range
DateTime dateValue = new DateTime(2020, 1, 1, 12, 12, 12);
workSheet["A3"].Value = dateValue;
workSheet["A4"].Value = new DateTime(2022, 3, 3, 10, 10, 10);
workSheet["A5"].Value = new DateTime(2021, 2, 2, 11, 11, 11);

IronXL.Range range = workSheet["A3:A5"];

// Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss";

workBook.SaveAs("dataFormats.xlsx");

Imports IronXL
Imports IronXL.Formatting
Imports System
Imports System.Linq

' Create a new workbook
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Set the data format to 12300.00%
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Percent2

' Set the data format to 123.0000
Private workSheet("A2").Value = 123
Private workSheet("A2").FormatString = "0.0000"

' Set data display format to range
Private dateValue As New DateTime(2020, 1, 1, 12, 12, 12)
Private workSheet("A3").Value = dateValue
Private workSheet("A4").Value = New DateTime(2022, 3, 3, 10, 10, 10)
Private workSheet("A5").Value = New DateTime(2021, 2, 2, 11, 11, 11)

Private range As IronXL.Range = workSheet("A3:A5")

' Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss"

workBook.SaveAs("dataFormats.xlsx")

Définir la valeur de la cellule en tant que chaîne de caractères

Lorsque vous définissez la valeur dans IronXL, utilisez StringValue au lieu de Value pour attribuer directement la valeur exacte à la cellule sans conversion automatique. Cette utilisation est similaire à l'insertion d'une apostrophe avant la valeur de la cellule dans Excel.

:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-stringvalue.cs

// Assign value as string
workSheet["A1"].StringValue = "4402-12";

' Assign value as string
workSheet("A1").StringValue = "4402-12"

Utiliser les formats intégrés Exemple

La bibliothèque IronXL offre une variété de chaînes de format prédéfinies auxquelles on peut accéder par l'intermédiaire de la classe IronXL.Formatting.BuiltinFormats pour le formatage des cellules Excel, ce qui vous permet de personnaliser l'affichage des données dans vos feuilles de calcul Excel.

:path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format-builtin-formats.cs

using IronXL;
using IronXL.Formatting;

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Use builtin formats
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Accounting0;

workBook.SaveAs("builtinDataFormats.xlsx");

Imports IronXL
Imports IronXL.Formatting

' Create a new workbook
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Use builtin formats
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Accounting0

workBook.SaveAs("builtinDataFormats.xlsx")

Formats de données intégrés disponibles

Pour le type Durée, les valeurs d'entrée sont représentées en jours. Par exemple, 1 jour équivaut à 24 heures, et 1,05 jour équivaut à 25 heures et 12 minutes. Voici les types de formats disponibles :

Description

• Général : Le format par défaut qui affiche les nombres tels qu'ils sont, sans formatage spécifique.
• Duration1 : Affiche les valeurs de durée en minutes et en secondes, comme "mm:ss" Les nombres entrés dans la propriété Value seront considérés comme des jours.
• Duration2 : Affiche les valeurs de durée en heures, minutes et secondes, comme "[h]:mm:ss."
• Duration3 : Affiche les valeurs de durée en minutes, secondes et millisecondes, comme "mm:ss.0"
• Comptabilité0 : Formate les valeurs comptables sans chiffres décimaux, en utilisant des parenthèses pour les valeurs négatives, comme "#,##0_");(#,##0)."
• Comptabilité0Rouge : Formate les valeurs comptables sans chiffres décimaux, en utilisant la couleur rouge pour les valeurs négatives, comme "#,##0_")rouge"
• Comptabilité2 : Formate les valeurs comptables avec deux chiffres décimaux, en utilisant des parenthèses pour les valeurs négatives, comme "#,##0.00 ;(#,##0.00)."
• Comptabilité2Rouge : Formate les valeurs comptables avec deux chiffres décimaux, en utilisant la couleur rouge pour les valeurs négatives, comme "#,##0.00_")rouge"
• Time1 : Formate les valeurs temporelles au format 12 heures avec AM/PM, comme "h:mm AM/PM"
• Time2 : Formate les valeurs temporelles au format 12 heures avec les secondes et AM/PM, comme "h:mm:ss AM/PM"
• Time3 : Formate les valeurs temporelles au format 24 heures sans les secondes, comme "h:mm"
• Time4 : Formate les valeurs temporelles au format 24 heures avec les secondes, comme "h:mm:ss"
• ShortDate : Formate les valeurs de date dans un format court, comme "m/d/yy"
• ShortDateAndTime : Formate les valeurs de date et d'heure dans un format court, comme "m/d/yy h:mm"
• LongDate1 : Formate les valeurs de la date dans un format long avec le mois, le jour et l'année, comme "d-mmm-yy"
• LongDate2 : Formate les valeurs de la date dans un format long avec le jour et le mois abrégé, comme "d-mmm"
• LongDate3 : Formate les valeurs de la date dans un format long avec un mois et une année abrégés, comme "mmm-yy"
• Fraction1 : Formate les valeurs fractionnaires avec un chiffre, comme "# ?/ ?"
• Fraction2 : Formate les valeurs fractionnaires avec deux chiffres, comme "# ??/ ???"
• Scientifique1 : Formate les nombres en notation scientifique avec un chiffre après le point, comme "##0.0E+0"
• Scientifique2 : Formule les nombres en notation scientifique avec deux chiffres après le point, comme "0.00E+00"
• Percent : Formate les valeurs en pourcentage sans chiffres décimaux, comme "0%"
• Percent2 : Formate les valeurs en pourcentage avec deux chiffres décimaux, comme "0.00%"
• Monnaie0 : Formate les valeurs monétaires sans chiffres décimaux, en utilisant des parenthèses pour les valeurs négatives, comme "$#,##0_");($#,##0)."
• Monnaie0Rouge : Formate les valeurs monétaires sans chiffres décimaux, en utilisant la couleur rouge pour les valeurs négatives, comme "$#,##0_")rouge"
• Monnaie2 : Formate les valeurs monétaires avec deux chiffres décimaux, en utilisant des parenthèses pour les valeurs négatives, comme "$#,##0.00 ;($#,##0.00)."
• Monnaie2Rouge : Formate les valeurs monétaires avec deux chiffres décimaux, en utilisant la couleur rouge pour les valeurs négatives, comme "$#,##0.00_")rouge"
• Milliers0 : Formate les nombres avec le séparateur de milliers et sans chiffres décimaux, comme "#,##0"
• Milliers2 : Formate les nombres avec le séparateur de milliers et deux chiffres décimaux, comme "#,##0.00"
• Nombre0 : Formate les nombres sans chiffres décimaux, comme "0"
• Number2 : Formate les nombres avec deux chiffres décimaux, comme "0.00"
• Text : Formate les valeurs de texte en texte brut, comme "@"(aucun formatage spécifique n'est appliqué).

Chaknith Bin

Ingénieur logiciel

Chaknith est le Sherlock Holmes des développeurs. C'est en s'amusant à relever des défis de code qu'il s'est rendu compte pour la première fois qu'il pourrait avoir un avenir dans le domaine de l'ingénierie logicielle. Il se concentre sur IronXL et IronBarcode, mais il est fier d'aider les clients avec chaque produit. Chaknith tire parti des connaissances qu'il a acquises en discutant directement avec les clients pour améliorer les produits eux-mêmes. Ses commentaires anecdotiques vont au-delà des tickets Jira et soutiennent le développement de produits, la documentation et le marketing, afin d'améliorer l'expérience globale des clients.Quand il n'est pas au bureau, on peut le trouver en train d'apprendre sur l'apprentissage automatique, le codage et la randonnée.