Настройки чисел
Настройка отображения чисел и дат
Одной из важнейших особенностей Microsoft Excel является возможность установки отображаемых форматов числовых значений и дат. Мы знаем, что числовые данные могут использоваться для представления различных значений, включая десятичные, валютные, процентные, дробные или бухгалтерские значения и т. д. Все эти числовые значения отображаются в различных форматах в зависимости от типа информации, которую они представляют. Аналогично, существует множество форматов, в которых дата или время могут быть отображены. Aspose.Cells поддерживает эту функциональность и позволяет разработчикам устанавливать отображаемый формат для числа или даты.
Установка форматов отображения в Microsoft Excel
Чтобы установить отображаемые форматы в Microsoft Excel:
- Щелкните правой кнопкой мыши любую ячейку.
- Выберите Формат ячеек. Появится диалоговое окно, которое используется для установки отображаемых форматов любого вида значений.
На левой стороне диалогового окна есть множество категорий значений, таких как Общее, Число, Валюта, Бухгалтерский учет, Дата, Время, Процент, и т. д. Aspose.Cells поддерживает все эти отображаемые форматы.
Использование встроенных форматов чисел
Aspose.Cells предлагает несколько встроенных форматов чисел для настройки форматов отображения чисел и дат. Все встроенные форматы чисел получают уникальные числовые значения. Разработчики могут назначить любое желаемое числовое значение методу 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 | @ |
// Instantiating a Workbook object | |
Workbook workbook = new Workbook(); | |
// Obtaining the reference of first worksheet | |
Worksheet worksheet = workbook.getWorksheets().get(0); | |
// Adding the current system date to "A1" cell | |
worksheet.getCells().get("A1").putValue(DateTime.getNow()); | |
// Getting the Style of the A1 Cell | |
Style 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("book1.out.xls"); |
Использование пользовательских числовых форматов
Чтобы определить собственную настраиваемую строку формата для установки формата отображения, используйте Custom. Этот подход не так быстр, как использование предустановленных форматов, но он более гибкий.
// Instantiating a Workbook object | |
Workbook workbook = new Workbook(); | |
// Obtaining the reference of first worksheet | |
Worksheet worksheet = workbook.getWorksheets().get(0); | |
// Adding the current system date to "A1" cell | |
worksheet.getCells().get("A1").putValue(DateTime.getNow()); | |
// Getting the Style of the A1 Cell | |
Style style = worksheet.getCells().get("A1").getStyle(); | |
// Setting the custom display format to show date as "d-mmm-yy" | |
style.setCustom("d-mmm-yy"); | |
// 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 custom display format to show value as percentage | |
style.setCustom("0.0%"); | |
// 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 custom display format to show value as currency | |
style.setCustom( "£#,##0;[Red]$-#,##0"); | |
// Applying the style to the A3 cell | |
worksheet.getCells().get("A3").setStyle(style); | |
// Saving the Excel file | |
workbook.save("book1.out.xls"); |