1. IronXL
2. Anleitungen
3. Zelldatenformate festlegen

Einstellen der Zelldatenformate

von Chaknith Bin

Mit der Daten- und Zahlenformatierung in Excel können Sie steuern, wie Zahlen, Datumsangaben, Uhrzeiten und andere Daten in den Zellen angezeigt werden, um die Lesbarkeit zu verbessern und die Genauigkeit der Daten zu gewährleisten. Mit Datenformaten können Sie Informationen in bestimmten Formaten wie Prozentsätzen oder Währungen darstellen. Auch bei den Zahlenformaten können Sie die Dezimalstellen und Anzeigeoptionen anpassen.

Mit der IronXL-Bibliothek können Sie das Daten- oder Zahlenformat in C# festlegen. Diese Bibliothek vereinfacht den Prozess des Erstellens, Formatierens und Manipulierens von Excel-Dateien auf programmatischem Wege, was sie zu einem wertvollen Werkzeug für die Datenverarbeitung und Präsentationsaufgaben in C#-Anwendungen macht.

Legen Sie los mit IronXL

Beginnen Sie noch heute mit der Verwendung von IronXL in Ihrem Projekt mit einer kostenlosen Testversion.

Erster Schritt:

Kostenloser Start

Zelldatenformate festlegen Beispiel

Auf die Eigenschaft FormatString kann sowohl über Zellen als auch über Bereiche zugegriffen werden. Daher ist es möglich, Datenformate für einzelne Zellen, Spalten, Zeilen und jeden ausgewählten Bereich festzulegen.

: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")

Zellenwert als String festlegen

Verwenden Sie beim Einstellen des Wertes in IronXL StringValue anstelle von Value, um der Zelle den exakten Wert ohne automatische Umrechnung direkt zuzuweisen. Diese Verwendung ist vergleichbar mit der Verwendung eines Apostrophs vor dem Zellwert 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"

Eingebaute Formate verwenden Beispiel

Die IronXL-Bibliothek bietet eine Vielzahl von vordefinierten Formatstrings, auf die über die Klasse IronXL.Formatting.BuiltinFormats zur Formatierung von Excel-Zellen zugegriffen werden kann, so dass Sie die Darstellung von Daten in Ihren Excel-Tabellenblättern individuell anpassen können.

: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")

Verfügbare eingebaute Datenformate

Für den Typ Duration werden die Eingabewerte in Tagen angegeben. So entspricht beispielsweise 1 Tag 24 Stunden und 1,05 Tage entsprechen 25 Stunden und 12 Minuten. Hier sind die verfügbaren Formattypen:

Beschreibung

• Allgemein: Das Standardformat, das die Zahlen so anzeigt, wie sie sind, ohne besondere Formatierung.
• Dauer1: Zeigt Dauerwerte in Minuten und Sekunden an, z. B. "mm:ss" Die in die Eigenschaft Wert eingegebenen Zahlen werden als Tage betrachtet.
• Dauer2: Zeigt die Dauer in Stunden, Minuten und Sekunden an, z. B. "[h]:mm:ss."
• Dauer3: Zeigt die Dauer in Minuten, Sekunden und Millisekunden an, z. B. "mm:ss.0"
• Buchhaltung0: Formatiert Buchhaltungswerte ohne Nachkommastellen und verwendet Klammern für negative Werte, wie "#,##0_);(#,##0)."
• Buchhaltung0Rot: Formatiert Buchhaltungswerte ohne Nachkommastellen und verwendet rote Farbe für negative Werte, wie "#,##0_)rot."
• Buchhaltung2: Formatiert Buchhaltungswerte mit zwei Dezimalstellen und verwendet Klammern für negative Werte, wie "#,##0.00";(#,##0.00)."
• Buchhaltung2Rot: Formatiert Buchhaltungswerte mit zwei Dezimalstellen, wobei die rote Farbe für negative Werte verwendet wird, wie "#,##0.00_")rot."
• Zeit1: Formatiert Zeitwerte im 12-Stunden-Format mit AM/PM, wie "h:mm AM/PM"
• Zeit2: Formatiert Zeitwerte im 12-Stunden-Format mit Sekunden und AM/PM, wie "h:mm:ss AM/PM"
• Zeit3: Formatiert Zeitwerte im 24-Stunden-Format ohne Sekunden, wie "h:mm"
• Zeit4: Formatiert Zeitwerte im 24-Stunden-Format mit Sekunden, wie "h:mm:ss"
• KurzDatum: Formatiert Datumswerte in einem kurzen Format, wie "m/d/yy"
• ShortDateAndTime: Formatiert Datums- und Zeitwerte in einem Kurzformat, wie "m/d/yy h:mm"
• LongDate1: Formatiert Datumswerte in einem langen Format mit Monat, Tag und Jahr, wie "d-mmm-yy"
• LongDate2: Formatiert Datumswerte in einem langen Format mit Tag und abgekürztem Monat, wie "d-mmm"
• LongDate3: Formatiert Datumswerte in einem langen Format mit abgekürztem Monat und Jahr, wie "mmm-yy"
• Bruch1: Formatiert Bruchwerte mit einer Ziffer, wie "# ?/?"
• Fraktion2: Formatiert Bruchwerte mit zwei Ziffern, wie "# ??/??"
• Scientific1: Formatiert Zahlen in wissenschaftlicher Notation mit einer Ziffer nach dem Punkt, wie "##0.0E+0"
• Wissenschaftlich2: Formatiert Zahlen in wissenschaftlicher Notation mit zwei Ziffern nach dem Punkt, z. B. "0.00E+00"
• Prozent: Formatiert Prozentwerte ohne Nachkommastellen, wie "0%"
• Prozent2: Formatiert Prozentwerte mit zwei Nachkommastellen, z. B. "0,00%"
• Währung0: Formatiert Währungswerte ohne Nachkommastellen und verwendet Klammern für negative Werte, wie "$#,##0_);($#,##0)."
• Währung0Rot: Formatiert Währungswerte ohne Nachkommastellen und verwendet rote Farbe für negative Werte, wie "$#,##0_)rot."
• Währung2: Formatiert Währungswerte mit zwei Dezimalstellen und verwendet Klammern für negative Werte wie "$#,##0.00";($#,##0.00)."
• Währung2Rot: Formatiert Währungswerte mit zwei Dezimalstellen, wobei die rote Farbe für negative Werte verwendet wird, wie "$#,##0.00_")rot."
• Tausender0: Formatiert Zahlen mit Tausendertrennzeichen und ohne Dezimalstellen, wie "#,##0"
• Tausender2: Formatiert Zahlen mit Tausendertrennzeichen und zwei Dezimalstellen, z. B. "#,##0.00"
• Zahl0: Formatiert Zahlen ohne Dezimalziffern, wie "0"
• Zahl2: Formatiert Zahlen mit zwei Dezimalstellen, z. B. "0.00"
• Text: Formatiert Textwerte als reinen Text, wie "@"(keine spezifische Formatierung vorgenommen).

Chaknith Bin

Software-Ingenieur

Chaknith ist der Sherlock Holmes der Entwickler. Zum ersten Mal kam ihm der Gedanke, dass er eine Zukunft in der Softwareentwicklung haben könnte, als er zum Spaß an Code Challenges teilnahm. Sein Schwerpunkt liegt auf IronXL und IronBarcode, aber er ist stolz darauf, Kunden mit jedem Produkt zu helfen. Chaknith nutzt sein Wissen aus direkten Gesprächen mit Kunden, um die Produkte selbst weiter zu verbessern. Sein anekdotisches Feedback geht über Jira-Tickets hinaus und unterstützt die Produktentwicklung, die Dokumentation und das Marketing, um das Gesamterlebnis der Kunden zu verbessern.Wenn er nicht im Büro ist, lernt er über maschinelles Lernen, programmiert und wandert.