数字の設定

数字と日付の表示形式を設定する方法

Microsoft Excelの非常に強力な機能の1つは、ユーザーが数値値や日付の表示形式を設定できることです。数値データは10進数、通貨、パーセンテージ、分数、会計などを含むさまざまな値を表すために使用できることを知っています。すべてのこれらの数値値は、それが表す情報の種類に応じて異なる形式で表示されます。同様に、日付や時刻を表示するための多くの形式があります。 Aspose.Cellsはこの機能をサポートし、開発者が数値や日付の表示形式を設定できるようにします。

Microsoft Excelで表示形式を設定する方法

Microsoft Excelで表示形式を設定するには：

1. 任意のセルを右クリックします。
2. セルの書式設定 を選択します。ダイアログが表示され、さまざまな種類の値の表示形式を設定するのに使用されます。

ダイアログの左側には一般、数値、通貨、会計、日付、時間、パーセンテージなどの値のカテゴリが多数あります。Aspose.Cellsはこれらすべての表示形式をサポートしています。

Aspose.Cellsは、Microsoft Excelファイルを表すWorkbookクラスを提供します。Workbookクラスには、Excelファイル内の各ワークシートにアクセスできるWorksheetsコレクションが含まれています。ワークシートはWorksheetクラスで表されます。WorksheetクラスはCellsコレクションを提供します。Cellsコレクション内の各項目はCellクラスのオブジェクトを表します。

Aspose.Cellsは、CellクラスのGetStyleおよびSetStyleメソッドを提供します。これらのメソッドはセルの書式設定を取得および設定するために使用されます。Styleクラスは、数値や日付の表示形式に対応するためのいくつかの有用なプロパティを提供します。

組み込みの数値形式の使用方法

Aspose.Cellsは、数値や日付の表示形式を構成するためのいくつかの組み込みの数値形式を提供しています。これらの組み込みの数値形式は、StyleオブジェクトのNumberプロパティを使用して適用できます。すべての組み込みの数値形式には固有の数値が割り当てられています。開発者はStyleオブジェクトのNumberプロパティに任意の数値を割り当てて、表示形式を適用することができます。この方法は高速です。Aspose.Cellsでサポートされている組み込みの数値形式は以下のとおりです。

値	タイプ	フォーマット文字列
0	General	General
1	Decimal	0
2	Decimal	0.00
3	Decimal	#,##0
4	Decimal	#,##0.00
5	Currency	$#,##0;$-#,##0
6	Currency	$#,##0;[Red]$-#,##0
7	Currency	$#,##0.00;$-#,##0.00
8	Currency	$#,##0.00;[Red]$-#,##0.00
9	Percentage	0%
10	Percentage	0.00%
11	Scientific	0.00E+00
12	Fraction	# ?/?
13	Fraction	# /
14	Date	m/d/yyyy
15	Date	d-mmm-yy
16	Date	d-mmm
17	Date	mmm-yy
18	Time	h:mm AM/PM
19	Time	h:mm:ss AM/PM
20	Time	h:mm
21	Time	h:mm:ss
22	Time	m/d/yy h:mm
37	Currency	#,##0;-#,##0
38	Currency	#,##0;[Red]-#,##0
39	Currency	#,##0.00;-#,##0.00
40	Currency	#,##0.00;[Red]-#,##0.00
41	Accounting	_ * #,##0_ ;_ * “_ ;_ @_
42	Accounting	_ $* #,##0_ ;_ $* “_ ;_ @_
43	Accounting	_ * #,##0.00_ ;_ * “??_ ;_ @_
44	Accounting	_ $* #,##0.00_ ;_ $* “??_ ;_ @_
45	Time	mm:ss
46	Time	h :mm:ss
47	Time	mm:ss.0
48	Scientific	##0.0E+00
49	Text	@

// 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);

カスタム数値形式の使用方法

表示形式を設定するために独自のカスタムフォーマット文字列を定義するには、StyleオブジェクトのCustomプロパティを使用します。この方法は事前に設定された形式を使用するよりも速くはありませんが、柔軟性があります。

// 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);

Customプロパティを使用して数値形式を設定する場合、Numberプロパティを使用して設定された以前の形式は上書きされ、その逆も同様です。

高度なトピック

• Style.Customプロパティを設定する際のカスタム数値形式を確認する
• サポートされている数値形式のリスト
• カスタム日付形式パターン g および ge mm dd の表現
• ブックでのカスタム数値小数点およびグループの区切りの指定
• DBNumカスタムパターンの書式設定の指定