1. IronXL
  2. Guides pratiques
  3. Définir les formats de données des cellules
Comment définir les formats de données des cellules dans Excel

How to Set Cell Data Formats

Chaknith Bin
Chaknith Bin
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Data formatting and number formatting in Excel allow you to control how numbers, dates, times, and other data are displayed in cells, enhancing readability and ensuring data accuracy. With data formats, you can present information in specific formats like percentages or currencies. Similarly, number formats let you customize decimal places and display options.

Quickstart: Apply Built-In Format to a Single Cell in One Line

This sample shows how easy it is to create a new Excel workbook and apply a built-in format to a specific cell using IronXL’s API. You’ll be up and running in seconds, with no Interop dependencies—just set “FormatString” and save.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronXL with NuGet Package Manager

    PM > Install-Package IronXL.Excel

  2. Copy and run this code snippet.

    IronXL.WorkBook book = IronXL.WorkBook.Create(); book.DefaultWorkSheet["B2"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2;

  3. Deploy to test on your live environment

    Start using IronXL in your project today with a free trial
    arrow pointer

Minimal Workflow (5 steps)

  1. Download the C# library to set data format
  2. Open existing or create a new Excel spreadsheet
  3. Set the FormatString property of the cell, column, row, or range to the desired data format
  4. Use the built-in data format with BuiltinFormats class
  5. Export the edited spreadsheet in various file types


Set Cell Data Formats Example

The FormatString property can be accessed through both cells and ranges. Therefore, it is possible to set data formats for individual cells, columns, rows, and any selected range.

: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")
$vbLabelText   $csharpLabel
Data Format

Set Cell Value as String

When setting the value in IronXL, use StringValue instead of Value to directly assign the exact value to the cell without automatic conversion. This usage is like placing an apostrophe before the cell value in 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"
$vbLabelText   $csharpLabel

Use Builtin Formats Example

The IronXL library offers a variety of predefined format strings that can be accessed through the IronXL.Formatting.BuiltinFormats class for formatting Excel cells. This allows you to customize how data is displayed in your Excel spreadsheets.

: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")
$vbLabelText   $csharpLabel

Available Builtin Data Formats

For the Duration type, input values are represented in days. For example, 1 day is equal to 24 hours, and 1.05 days is equivalent to 25 hours and 12 minutes. Here are the available format types:

All Available Data Formats

Description

  • General: The default format that displays numbers as they are without any specific formatting.
  • Duration1: Displays duration values in minutes and seconds, like "mm:ss." Number input into the Value property will be considered as days.
  • Duration2: Displays duration values in hours, minutes, and seconds, like "[h]:mm:ss."
  • Duration3: Displays duration values in minutes, seconds, and milliseconds, like "mm:ss.0."
  • Accounting0: Formats accounting values without decimal digits, using parentheses for negative values, like "#,##0_);(#,##0)."
  • Accounting0Red: Formats accounting values without decimal digits, using red color for negative values, like "#,##0_);Red."
  • Accounting2: Formats accounting values with two decimal digits, using parentheses for negative values, like "#,##0.00;(#,##0.00)."
  • Accounting2Red: Formats accounting values with two decimal digits, using red color for negative values, like "#,##0.00_);Red."
  • Time1: Formats time values in 12-hour clock format with AM/PM, like "h:mm AM/PM."
  • Time2: Formats time values in 12-hour clock format with seconds and AM/PM, like "h:mm:ss AM/PM."
  • Time3: Formats time values in 24-hour clock format without seconds, like "h:mm."
  • Time4: Formats time values in 24-hour clock format with seconds, like "h:mm:ss."
  • ShortDate: Formats date values in a short format, like "m/d/yy."
  • ShortDateAndTime: Formats date and time values in a short format, like "m/d/yy h:mm."
  • LongDate1: Formats date values in a long format with month, day, and year, like "d-mmm-yy."
  • LongDate2: Formats date values in a long format with day and abbreviated month, like "d-mmm."
  • LongDate3: Formats date values in a long format with abbreviated month and year, like "mmm-yy."
  • Fraction1: Formats fractional values with one digit, like "# ?/?."
  • Fraction2: Formats fractional values with two digits, like "# ??/??."
  • Scientific1: Formats numbers in scientific notation with one digit after the dot, like "##0.0E+0."
  • Scientific2: Formats numbers in scientific notation with two digits after the dot, like "0.00E+00."
  • Percent: Formats percentage values without decimal digits, like "0%."
  • Percent2: Formats percentage values with two decimal digits, like "0.00%."
  • Currency0: Formats currency values without decimal digits, using parentheses for negative values, like "$#,##0_);($#,##0)."
  • Currency0Red: Formats currency values without decimal digits, using red color for negative values, like "$#,##0_);Red."
  • Currency2: Formats currency values with two decimal digits, using parentheses for negative values, like "$#,##0.00;($#,##0.00)."
  • Currency2Red: Formats currency values with two decimal digits, using red color for negative values, like "$#,##0.00_);Red."
  • Thousands0: Formats numbers with thousands separator and no decimal digits, like "#,##0."
  • Thousands2: Formats numbers with thousands separator and two decimal digits, like "#,##0.00."
  • Number0: Formats numbers without decimal digits, like "0."
  • Number2: Formats numbers with two decimal digits, like "0.00."
  • Text: Formats text values as plain text, like "@" (no specific formatting applied).

Questions Fréquemment Posées

Comment puis-je définir des formats de données de cellules dans Excel en utilisant C# ?

Vous pouvez définir des formats de données de cellules dans Excel en utilisant IronXL en accédant à une feuille de calcul et en définissant la propriété FormatString d'une cellule. Cela permet de personnaliser la manière dont les données sont affichées, comme les nombres, les dates et les heures, sans utiliser Interop.

Quels sont les avantages de l'utilisation d'une bibliothèque C# pour la mise en forme des données Excel ?

L'utilisation d'une bibliothèque C# comme IronXL pour la mise en forme des données Excel vous permet de contrôler de manière programmatique l'apparence des données, d'améliorer la lisibilité, d'assurer l'exactitude des données et d'éviter les complexités d'utilisation d'Interop. Cela simplifie les tâches telles que l'établissement de formats de nombres, de dates et de formats personnalisés.

Comment appliquer un format de numéro personnalisé à une cellule dans Excel avec C# ?

Pour appliquer un format de numéro personnalisé à une cellule en utilisant IronXL, chargez votre classeur Excel, accédez à la feuille de calcul et définissez la propriété FormatString de la cellule au format personnalisé souhaité. Par exemple, pour afficher un nombre sous forme de pourcentage, utilisez sheet["A1"].FormatString = "0.00%".

Puis-je préserver les zéros en tête dans les cellules Excel en utilisant une bibliothèque C# ?

Oui, avec IronXL, vous pouvez préserver les zéros en tête en utilisant la propriété StringValue lors de la définition de la valeur d'une cellule. Cette approche empêche la conversion automatique et conserve les zéros en tête dans la cellule.

Comment formater des cellules Excel avec des styles comptables en utilisant C# ?

Pour formater des cellules Excel avec des styles comptables en utilisant IronXL, utilisez la classe BuiltinFormats. Par exemple, vous pouvez appliquer un format comptable avec deux décimales avec sheet["C3"].FormatString = IronXL.Formatting.BuiltinFormats.Accounting2.

Quels sont quelques formats de données prédéfinis disponibles dans une bibliothèque C# pour Excel ?

IronXL fournit des formats de données prédéfinis tels que comptabilité, durée, heure, date, fraction, scientifique, pourcentage, monnaie et nombre. Ces formats intégrés simplifient la personnalisation de la présentation des données dans les feuilles de calcul Excel.

Comment puis-je afficher les valeurs de monnaie négatives en rouge dans Excel en utilisant C# ?

Pour afficher les valeurs de monnaie négatives en rouge en utilisant IronXL, définissez la propriété FormatString sur un format de monnaie qui inclut le rouge pour les négatifs, tel que Currency0Red ou Currency2Red. Par exemple : sheet["B4"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2Red.

Quelle est la différence entre les formats Number0 et Number2 dans IronXL ?

Dans IronXL, le format Number0 affiche les nombres sans chiffres décimaux, tandis que le format Number2 affiche les nombres avec deux chiffres décimaux. Ces formats aident à personnaliser la précision des données numériques dans les feuilles Excel.

Comment enregistrer les modifications apportées à un classeur Excel après l'avoir formaté en utilisant C# ?

Pour enregistrer les modifications apportées à un classeur Excel après l'avoir formaté avec IronXL, utilisez la méthode SaveAs sur l'objet WorkBook. Spécifiez le nom de fichier et le format souhaités pour enregistrer le classeur mis à jour.

Quels sont quelques conseils de dépannage pour définir des formats de données dans Excel en utilisant une bibliothèque C# ?

Lorsque vous définissez des formats de données dans Excel en utilisant IronXL, assurez-vous que la bibliothèque est correctement intégrée, vérifiez que les chaînes de format utilisées sont exactes et vérifiez toute exception survenant pendant le processus d'enregistrement du classeur. En outre, envisagez d'utiliser la propriété StringValue pour une saisie de données précise.

Chaknith Bin
Chaknith Bin
  Discutez maintenant avec l'équipe d'ingénierie
Ingénieur logiciel
Chaknith travaille sur IronXL et IronBarcode. Il a une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, documentation et expérience globale.
Prêt à commencer?
Nuget Téléchargements 1,686,155 | Version : 2025.11 vient de sortir