Excel\u3067\u30bb\u30eb\u306e\u30c7\u30fc\u30bf\u5f62\u5f0f\u3092\u8a2d\u5b9a\u3059\u308b\u65b9\u6cd5<\/S>

IronXL を使用して C# でセルのデータ形式を設定する方法

This article was translated from English: Does it need improvement?
Translated
View the article in English

Excel のデータ形式や数値形式を使用すると、セル内の数値、日付、時刻、その他のデータの表示方法を制御でき、読みやすさを向上させ、データの正確性を確保します。 データ形式を使用すると、パーセンテージや通貨などの特定の形式で情報を表示できます。 同様に、数値形式では小数点以下の桁数や表示オプションをカスタマイズできます。

見出しとして:2(クイックスタート: 1行で単一セルに組み込み形式を適用する)

このサンプルは、IronXL の API を使用して新しい Excel ワークブックを作成し、特定のセルに組み込みの形式を適用する方法を示します。 数秒で起動し、Interop 依存関係なしに動作します。"FormatString" を設定して保存するだけです。

Nuget Icon今すぐ NuGet で PDF を作成してみましょう:

  1. NuGet パッケージ マネージャーを使用して IronXL をインストールします

    PM > Install-Package IronXL.Excel

  2. このコード スニペットをコピーして実行します。

    IronXL.WorkBook book = IronXL.WorkBook.Create(); book.DefaultWorkSheet["B2"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2;
  3. 実際の環境でテストするためにデプロイする

    今すぐ無料トライアルでプロジェクトに IronXL を使い始めましょう
    arrow pointer


セルデータ形式設定の例

FormatString プロパティには、セルと範囲の両方からアクセス可能です。 したがって、個々のセル、列、行、選択された範囲に対してデータ形式を設定できます。

: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
データ形式

セル値を文字列として設定

IronXL で値を設定する際は、Value の代わりに StringValue を使用して、自動変換なしでセルに正確な値を直接割り当てます。 この使用法は、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

組み込み形式の使用例

IronXL ライブラリは、Excel セルの書式設定に使用できるさまざまな定義済み形式文字列を IronXL.Formatting.BuiltinFormats クラスを介して提供しています。 これにより、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")
$vbLabelText   $csharpLabel

利用可能な組み込みデータ形式

Duration タイプの場合、入力値は日数で表されます。 例えば、1 日は 24 時間であり、1.05 日は 25 時間 12 分に相当します。 利用可能な形式タイプは以下の通りです。

利用可能なすべてのデータ形式

説明

  • General: 特定の書式設定を行わずに数値をそのまま表示するデフォルト形式。
  • Duration1: 時間の値を分と秒で表示し、"mm:ss"のようにします。Value プロパティに入力する数値は日数と見なされます。
  • Duration2: 時間の値を時、分、秒で表示し、"[h]:mm:ss"のようにします。
  • Duration3: 時間の値を分、秒、ミリ秒で表示し、"mm:ss.0"のようにします。
  • Accounting0: 会計値を小数点以下の桁数なしで書式設定し、負の値には括弧を使用します。"#,##0_);(#,##0)"のようにします。
  • Accounting0Red: 会計値を小数点以下の桁数なしで書式設定し、負の値には赤色を使用します。"#,##0_);Red"のようにします。
  • Accounting2: 会計値を小数点以下 2 桁で書式設定し、負の値には括弧を使用します。"#,##0.00;(#,##0.00)"のようにします。
  • Accounting2Red: 会計値を小数点以下 2 桁で書式設定し、負の値には赤色を使用します。"#,##0.00_);Red"のようにします。
  • Time1: AM/PM で 12 時間形式で時間の値を表示し、"h:mm AM/PM"のようにします。
  • Time2: 秒を含む AM/PM で 12 時間形式で時間の値を表示し、"h:mm:ss AM/PM"のようにします。
  • Time3: 秒を含まない 24 時間形式で時間の値を表示し、"h:mm"のようにします。
  • Time4: 秒を含む 24 時間形式で時間の値を表示し、"h:mm:ss"のようにします。
  • ShortDate: 短い形式で日付の値を表示し、"m/d/yy"のようにします。
  • ShortDateAndTime: 短い形式で日付と時刻の値を表示し、"m/d/yy h:mm"のようにします。
  • LongDate1: 月日年を含む長い形式で日付の値を表示し、"d-mmm-yy"のようにします。
  • LongDate2: 日と月の略を含む長い形式で日付の値を表示し、"d-mmm"のようにします。
  • LongDate3: 月の略称と年を含む長い形式で日付の値を表示し、"mmm-yy"のようにします。
  • Fraction1: 1 桁の分数値を表示する形式。"# ?/?"のようにします。
  • Fraction2: 2 桁の分数値を表示する形式。"# ??/??"のようにします。
  • Scientific1: 小数点後に 1 桁の桁数を持つ科学表記法の数値を表示する形式。"##0.0E+0"のようにします。
  • Scientific2: 小数点後に 2 桁の桁数を持つ科学表記法の数値を表示する形式。"0.00E+00"のようにします。
  • Percent: 小数点以下の桁数なしでパーセント値を表示する形式。"0%"のようにします。
  • Percent2: 小数点以下 2 桁でパーセント値を表示する形式。"0.00%"のようにします。
  • Currency0: 会計値を小数点以下の桁数なしで書式設定し、負の値には括弧を使用します。"$#,##0_);($#,##0)"のようにします。
  • Currency0Red: 会計値を小数点以下の桁数なしで書式設定し、負の値には赤色を使用します。"$#,##0_);Red"のようにします。
  • Currency2: 会計値を小数点以下 2 桁で書式設定し、負の値には括弧を使用します。"$#,##0.00;($#,##0.00)"のようにします。
  • Currency2Red: 会計値を小数点以下 2 桁で書式設定し、負の値には赤色を使用します。"$#,##0.00_);Red"のようにします。
  • Thousands0: 小数点以下の桁数なしで数値を千区切りで書式設定します。"#,##0"のようにします。
  • Thousands2: 小数点以下 2 桁で数値を千区切りで書式設定します。"#,##0.00"のようにします。
  • Number0: 小数点以下の桁数なしで数値を表示する形式。"0"のようにします。
  • Number2: 小数点以下 2 桁で数値を表示する形式。"0.00"のようにします。
  • Text: テキスト値をプレーンテキストとして表示する形式。"@"のようにします(特定の書式設定は適用されません)。

よくある質問

C#を使用してExcelでセルデータ形式を設定するにはどうすればよいですか?

IronXLを使用してExcelのセルデータ形式を設定するには、ワークシートにアクセスし、セルのFormatStringプロパティを設定します。これにより、数値、日付、時間などのデータの表示方法をカスタマイズできます。

ExcelデータフォーマットのためにC#ライブラリを使用することの利点は何ですか?

IronXLのようなC#ライブラリを使用してExcelデータフォーマットを行うことで、データの外観をプログラムで制御し、読みやすさを向上し、データの正確性を確保し、Interopを使用する複雑さを回避できます。番号形式、日付、カスタム形式の設定などのタスクが簡素化されます。

C#でExcelのセルにカスタム番号形式を適用するにはどうすればよいですか?

IronXLを使用してセルにカスタム数値形式を適用するには、Excelワークブックをロードし、ワークシートにアクセスして、セルのFormatStringプロパティを希望のカスタム形式に設定します。例えば、数値をパーセンテージとして表示するには、sheet["A1"].FormatString = "0.00%"を使用します。

C#ライブラリを使用してExcelセルで先行ゼロを保持できますか?

はい、IronXLを使用すると、StringValueプロパティを使用してセルの値を設定することで先頭ゼロを保持できます。この方法は自動変換を防ぎ、セル内の先頭ゼロを保持します。

C#を使用して会計スタイルでExcelセルをフォーマットするにはどうすればよいですか?

IronXLを使用して会計スタイルのExcelセルをフォーマットするには、BuiltinFormatsクラスを利用します。たとえば、2桁の小数点を持つ会計形式を適用するには、sheet["C3"].FormatString = IronXL.Formatting.BuiltinFormats.Accounting2を使用します。

C#ライブラリでExcelのために利用できる事前定義されたデータ形式にはどのようなものがありますか?

IronXLは、会計、期間、時刻、日付、分数、科学的、百分率、通貨、番号などの事前定義されたデータ形式を提供しています。これらの組み込み形式はExcelスプレッドシート内のデータプレゼンテーションのカスタマイズを簡素化します。

C#を使用してExcelで負の通貨値を赤で表示するにはどうすればよいですか?

IronXLを使用して負の通貨値を赤で表示するには、FormatStringプロパティを負の数値に赤色を含む通貨形式に設定します。例えば、Currency0RedCurrency2Redなどです。例:sheet["B4"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2Red

IronXL の Number0 形式と Number2 形式の違いは何ですか?

IronXLでは、Number0形式は小数点なしの数を表示し、Number2形式は小数点以下2桁の数を表示します。これらの形式は、Excelシート内の数値データの精度をカスタマイズするのに役立ちます。

C#を使用してフォーマットされた後のExcelワークブックへの変更を保存するにはどうすればよいですか?

IronXLを使用してExcelワークブックをフォーマットした後に変更を保存するには、WorkBookオブジェクトのSaveAsメソッドを使用します。希望のファイル名と形式を指定して、更新されたワークブックを保存します。

C#ライブラリを使用してExcelでデータ形式を設定する際のトラブルシューティングのヒントはありますか?

IronXLを使用してExcelでデータ形式を設定する際には、ライブラリが正しく統合されていることを確認し、使用するフォーマット文字列が正確であることを確認し、ワークブックの保存プロセス中に例外が発生していないかを確認してください。また、正確なデータ入力のためにStringValueプロパティを使用することも検討してください。

Chaknith Bin
ソフトウェアエンジニア
ChaknithはIronXLとIronBarcodeに取り組んでいます。彼はC#と.NETの深い専門知識を持ち、ソフトウェアの改善や顧客サポートに貢献しています。ユーザーとの対話から得られる洞察が、より良い製品、ドキュメント、および全体的な経験に寄与しています。
準備はできましたか?
Nuget ダウンロード 1,738,553 | Version: 2025.11 リリース