Paramètres du numéro

Définition des formats d’affichage de Numbers et des dates

Une caractéristique très forte de Microsoft Excel est qu’il permet aux utilisateurs de définir les formats d’affichage des valeurs numériques et des dates. Nous savons que les données numériques peuvent être utilisées pour représenter différentes valeurs, notamment des valeurs décimales, monétaires, de pourcentage, de fraction ou comptables, etc. Toutes ces valeurs numériques sont affichées dans différents formats en fonction du type d’informations qu’elles représentent. De même, il existe de nombreux formats dans lesquels une date ou une heure peut être affichée. Aspose.Cells prend en charge cette fonctionnalité et permet aux développeurs de définir n’importe quel format d’affichage pour un nombre ou une date.

Définition des formats d’affichage dans Microsoft Excel

Pour définir les formats d’affichage dans Microsoft Excel :

1. Cliquez avec le bouton droit sur n’importe quelle cellule.
2. SélectionnerFormat Cells. Une boîte de dialogue apparaîtra qui est utilisée pour définir les formats d’affichage de tout type de valeur.

Dans la partie gauche de la boîte de dialogue, il existe de nombreuses catégories de valeurs telles queGénéral, Nombre, Devise, Comptabilité, Date, Temps, **Pourcentage,**etc. Aspose.Cells prend en charge tous ces formats d’affichage.

Aspose.Cells fournit une classe,Cahier qui représente un fichier Excel Microsoft. LeCahier classe contient unFeuilles de travail collection qui permet d’accéder à chaque feuille de calcul dans le fichier Excel. Une feuille de calcul est représentée par leFeuille de travail classe. LeFeuille de travail la classe offre uneCells le recueil. Chaque élément de laCells collection représente un objet de laCellclasse.

Aspose.Cells fournitObtenirStyle etDéfinirStyle méthodes pour laCell classe. Ces méthodes sont utilisées pour obtenir et définir la mise en forme d’une cellule. LeStylefournit des propriétés utiles pour gérer les formats d’affichage des nombres et des dates.

Utilisation des formats numériques intégrés

Aspose.Cells propose des formats de nombres intégrés pour configurer les formats d’affichage des nombres et des dates. Ces formats numériques intégrés peuvent être appliqués à l’aide de laNombre propriété de laStyle objet. Tous les formats numériques intégrés reçoivent des valeurs numériques uniques. Les développeurs peuvent attribuer n’importe quelle valeur numérique souhaitée auNombre propriété de laStyleobjet pour appliquer le format d’affichage. Cette approche est rapide. Les formats numériques intégrés pris en charge par Aspose.Cells sont répertoriés ci-dessous.

Évaluer	Taper	Formater la chaîne
0	Général	Général
1	Décimal	0
2	Décimal	0.00
3	Décimal	# ,##0
4	Décimal	# ,##0.00
5	Devise	$#,##0;$-#,##0
6	Devise	$#,##0;[Rouge]$-#,##0
7	Devise	$#,##0.00;$-#,##0.00
8	Devise	$#,##0.00 ;[Rouge]$-#,##0.00
9	Pourcentage	0%
10	Pourcentage	0.00%
11	Scientifique	0.00E+00
12	Fraction	# ?/?
13	Fraction	# /
14	Date	m/j/aa
15	Date	j-mmm-aa
16	Date	d-mmm
17	Date	mmm-aa
18	Temps	h:mm AM/PM
19	Temps	h:mm:ss AM/PM
20	Temps	hmm
21	Temps	h:mm:ss
22	Temps	j/j/aa h:mm
37	Devise	# ,##0;-#,##0
38	Devise	# ,##0;[Rouge]-#,##0
39	Devise	# ,##0.00;-#,##0.00
40	Devise	# ,##0.00;[Rouge]-#,##0.00
41	Comptabilité	_ * #,##0_ ;_ * “_ ;_ @_
42	Comptabilité	_ $* #,##0_ ;_ $* “_ ;_ @_
43	Comptabilité	_ * #,##0.00_ ;_ * “??_ ;_ @_
44	Comptabilité	_ $* #,##0.00_ ;_ $* “??_ ;_ @_
45	Temps	mm:ss
46	Temps	h :mm:ss
47	Temps	mm:ss.0
48	Scientifique	## 0.0E+00
49	Texte	@

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Obtaining the reference of first worksheet
Worksheet worksheet = workbook.Worksheets[0];

// Adding the current system date to "A1" cell
worksheet.Cells["A1"].PutValue(DateTime.Now);

// Getting the Style of the A1 Cell
Style style = worksheet.Cells["A1"].GetStyle();

// Setting the display format to number 15 to show date as "d-mmm-yy"
style.Number = 15;

// Applying the style to the A1 cell
worksheet.Cells["A1"].SetStyle(style);

// Adding a numeric value to "A2" cell
worksheet.Cells["A2"].PutValue(20);

// Getting the Style of the A2 Cell
style = worksheet.Cells["A2"].GetStyle();

// Setting the display format to number 9 to show value as percentage
style.Number = 9;

// Applying the style to the A2 cell
worksheet.Cells["A2"].SetStyle(style);

// Adding a numeric value to "A3" cell
worksheet.Cells["A3"].PutValue(2546);

// Getting the Style of the A3 Cell
style = worksheet.Cells["A3"].GetStyle();

// Setting the display format to number 6 to show value as currency
style.Number = 6;

// Applying the style to the A3 cell
worksheet.Cells["A3"].SetStyle(style);

// Saving the Excel file
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);

Utilisation de formats numériques personnalisés

Pour définir votre propre chaîne de format personnalisée pour définir le format d’affichage, utilisez laStyle objetsPersonnaliséla propriété. Cette approche n’est pas aussi rapide que l’utilisation de formats prédéfinis, mais elle est plus flexible.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Adding a new worksheet to the Excel object
int i = workbook.Worksheets.Add();

// Obtaining the reference of the newly added worksheet by passing its sheet index
Worksheet worksheet = workbook.Worksheets[i];

// Adding the current system date to "A1" cell
worksheet.Cells["A1"].PutValue(DateTime.Now);

// Getting the style of A1 cell
Style style = worksheet.Cells["A1"].GetStyle();

// Setting the custom display format to show date as "d-mmm-yy"
style.Custom = "d-mmm-yy";

// Applying the style to A1 cell
worksheet.Cells["A1"].SetStyle(style);

// Adding a numeric value to "A2" cell
worksheet.Cells["A2"].PutValue(20);

// Getting the style of A2 cell
style = worksheet.Cells["A2"].GetStyle();

// Setting the custom display format to show value as percentage
style.Custom = "0.0%";

// Applying the style to A2 cell
worksheet.Cells["A2"].SetStyle(style);

// Adding a numeric value to "A3" cell
worksheet.Cells["A3"].PutValue(2546);

// Getting the style of A3 cell
style = worksheet.Cells["A3"].GetStyle();

// Setting the custom display format to show value as currency
style.Custom = "£#,##0;[Red]$-#,##0";

// Applying the style to A3 cell
worksheet.Cells["A3"].SetStyle(style);

// Saving the Excel file
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);

Si vous utilisez lePersonnalisé propriété pour définir le format numérique, tout format précédent défini à l’aide de laNombrepropriété est remplacée et vice versa.

Sujets avancés

• Vérifier le format numérique personnalisé lors de la définition de la propriété Style.Custom
• Liste des formats de nombre pris en charge
• Modèle de format de date personnalisé de rendu g et ge mm jj
• Spécifier des séparateurs décimaux et de groupe personnalisés pour le classeur
• Spécification du format de modèle personnalisé DBNum