数字の設定

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

Microsoft Excelの非常に優れた特徴の一つは、数値と日付の表示形式を設定できることです。数値データは、十進法、通貨、パーセンテージ、分数、簿記値など、さまざまな値を表すために使用できます。これら全ての数値は、その値が表す情報の種類に応じて異なるフォーマットで表示されます。同様に、日付や時間も多くの表示形式があります。
Aspose.Cellsはこの機能をサポートし、開発者が数値や日付の表示形式を設定できるようにします。

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

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

1. 任意のセルを右クリックします。
2. セルの書式設定を選択します。ダイアログが表示され、あらゆる種類の値の表示フォーマットを設定できます。

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

Aspose.Cellsは、Excelファイルを表すモジュールWorkbookを提供しています。Workbookモジュールには、Excelファイル内の各ワークシートにアクセスできるWorksheetsコレクションがあります。ワークシートはWorksheetモジュールによって表されます。WorksheetモジュールはCellsコレクションを提供し、その中の各アイテムはCellクラスのオブジェクトを示します。

Aspose.Cellsは、Cellモジュールのセルのフォーマット設定と取得に関するgetStyle()とsetStyle(Style)メソッドを提供します。これらのメソッドを使ってセルの書式設定を操作します。Styleモジュールは、数値と日付の表示フォーマットを扱うための便利なプロパティも提供しています。

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

Aspose.Cells は、数値と日時の表示形式を設定するためのいくつかの組み込み番号形式を提供します。これらの組み込み番号形式は、Style オブジェクトの setNumber(number) メソッドを使用して適用できます。すべての組み込み番号形式には、固有の数値値が割り当てられています。開発者は、Style オブジェクトの setNumber(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	@

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Create directory if it is not already present.
const fs = require("fs");
if (!fs.existsSync(dataDir)) {
    fs.mkdirSync(dataDir);
}

// Instantiating a Workbook object
const workbook = new AsposeCells.Workbook();

// Obtaining the reference of the first worksheet
const worksheet = workbook.getWorksheets().get(0);

// Adding the current system date to "A1" cell
worksheet.getCells().get("A1").putValue(new Date());

// Getting the Style of the A1 Cell
let style = worksheet.getCells().get("A1").getStyle();

// Setting the display format to number 15 to show date as "d-mmm-yy"
style.setNumber(15);

// Applying the style to the A1 cell
worksheet.getCells().get("A1").setStyle(style);

// Adding a numeric value to "A2" cell
worksheet.getCells().get("A2").putValue(20);

// Getting the Style of the A2 Cell
style = worksheet.getCells().get("A2").getStyle();

// Setting the display format to number 9 to show value as percentage
style.setNumber(9);

// Applying the style to the A2 cell
worksheet.getCells().get("A2").setStyle(style);

// Adding a numeric value to "A3" cell
worksheet.getCells().get("A3").putValue(2546);

// Getting the Style of the A3 Cell
style = worksheet.getCells().get("A3").getStyle();

// Setting the display format to number 6 to show value as currency
style.setNumber(6);

// Applying the style to the A3 cell
worksheet.getCells().get("A3").setStyle(style);

// Saving the Excel file
workbook.save(path.join(dataDir, "book1.out.xls"), AsposeCells.SaveFormat.Excel97To2003);

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

表示形式のカスタム形式文字列を定義するには、Style オブジェクトの setCustom(string) メソッドを使用します。この方法は事前設定された形式を使用するよりも遅いですが、より柔軟です。

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Create directory if it is not already present.
const fs = require("fs");
if (!fs.existsSync(dataDir)) {
    fs.mkdirSync(dataDir);
}

// Instantiating a Workbook object
const workbook = new AsposeCells.Workbook();

// Obtaining the reference of the first worksheet
const worksheet = workbook.getWorksheets().get(0);

// Adding the current system date to "A1" cell
worksheet.getCells().get("A1").putValue(new Date());

// Getting the Style of the A1 Cell
let style = worksheet.getCells().get("A1").getStyle();

// Setting the display format to number 15 to show date as "d-mmm-yy"
style.setNumber(15);

// Applying the style to the A1 cell
worksheet.getCells().get("A1").setStyle(style);

// Adding a numeric value to "A2" cell
worksheet.getCells().get("A2").putValue(20);

// Getting the Style of the A2 Cell
style = worksheet.getCells().get("A2").getStyle();

// Setting the display format to number 9 to show value as percentage
style.setNumber(9);

// Applying the style to the A2 cell
worksheet.getCells().get("A2").setStyle(style);

// Adding a numeric value to "A3" cell
worksheet.getCells().get("A3").putValue(2546);

// Getting the Style of the A3 Cell
style = worksheet.getCells().get("A3").getStyle();

// Setting the display format to number 6 to show value as currency
style.setNumber(6);

// Applying the style to the A3 cell
worksheet.getCells().get("A3").setStyle(style);

// Saving the Excel file
workbook.save(path.join(dataDir, "book1.out.xls"), AsposeCells.SaveFormat.Excel97To2003);

番号形式を設定するために setCustom(string) メソッドを使用すると、以前 [**setNumber(number)**](https://reference.aspose.com/cells/nodejs-cpp/style/#setNumber-number-) メソッドで設定された形式は上書きされます。逆も同様です。

高度なトピック

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