Настройки чисел

Как установить отображаемые форматы чисел и дат

Одной из сильных сторон Microsoft Excel является возможность задавать форматы отображения числовых значений и дат. Мы знаем, что числовые данные могут использоваться для представления различных значений, включая десятичные, валютные, процентные, дробные или бухгалтерские значения и т. д. Все эти числовые значения отображаются в различных форматах в зависимости от типа информации, которую они представляют. Аналогично, существует множество форматов отображения даты или времени.
Aspose.Cells поддерживает эту функциональность и позволяет разработчикам устанавливать отображаемый формат для числа или даты.

Как установить отображаемые форматы в Microsoft Excel

Чтобы установить отображаемые форматы в Microsoft Excel:

  1. Щелкните правой кнопкой мыши любую ячейку.
  2. Выберите Формат ячеек. Появится диалоговое окно, в котором можно установить форматы отображения для любого значения.

Слева в диалоговом окне есть множество категорий значений, таких как Общий, Число, Валюта, Бухгалтерия, Дата, Время, Процент и др. Aspose.Cells поддерживает все эти форматы отображения.

Aspose.Cells предоставляет модуль, Workbook, который представляет файл Excel. Модуль Workbook содержит коллекцию Worksheets, которая позволяет получить доступ к каждому листу в файле Excel. Лист представлен модулем Worksheet. Модуль Worksheet предоставляет коллекцию Cells. Каждый элемент в коллекции Cells представляет объект модуля Cell.

Aspose.Cells предоставляет методы getStyle() и setStyle(Style) для модуля Cell. Эти методы используются для получения и установки форматирования ячейки. Модуль Style предоставляет полезные свойства для работы с форматами отображения чисел и дат.

Как использовать встроенные форматы чисел

Aspose.Cells предлагает некоторые встроенные форматы чисел для настройки отображения чисел и дат. Эти встроенные форматы могут применяться с помощью метода setNumber(number) объекта Style. Все встроенные форматы имеют уникальные числовые значения. Разработчики могут присваивать любое желаемое числовое значение методу setNumber(number) объекта Style для применения формата отображения. Этот подход быстрый. Ниже приведен список поддерживаемых встроенных форматов чисел 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 т:мм:сс
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);

Как использовать пользовательские форматы чисел

Чтобы определить собственный формат строки для настройки формата отображения, используйте метод setCustom(string) объекта Style. Этот подход менее быстр, чем использование предустановленных форматов, но более гибкий.

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

Продвинутые темы