Настройки чисел
Как установить отображаемые форматы чисел и дат
Одной из важнейших особенностей Microsoft Excel является возможность установки отображаемых форматов числовых значений и дат. Мы знаем, что числовые данные могут использоваться для представления различных значений, включая десятичные, валютные, процентные, дробные или бухгалтерские значения и т. д. Все эти числовые значения отображаются в различных форматах в зависимости от типа информации, которую они представляют. Аналогично, существует множество форматов, в которых дата или время могут быть отображены. Aspose.Cells поддерживает эту функциональность и позволяет разработчикам устанавливать отображаемый формат для числа или даты.
Как установить отображаемые форматы в Microsoft Excel
Чтобы установить отображаемые форматы в Microsoft Excel:
- Щелкните правой кнопкой мыши любую ячейку.
- Выберите Формат ячеек. Появится диалоговое окно, которое используется для установки отображаемых форматов любого вида значений.
На левой стороне диалогового окна есть множество категорий значений, таких как Общее, Число, Валюта, Бухгалтерский учет, Дата, Время, Процент, и т. д. Aspose.Cells поддерживает все эти отображаемые форматы.
Aspose.Cells предоставляет класс Workbook, который представляет файл Microsoft Excel. Класс Workbook содержит коллекцию Worksheets, которая позволяет получить доступ к каждому листу Excel-файла. Лист представлен классом Worksheet. Класс Worksheet предоставляет коллекцию Cells. Каждый элемент в коллекции Cells представляет объект класса Cell.
Aspose.Cells предоставляет методы GetStyle и SetStyle класса Cell. Эти методы используются для получения и установки форматирования ячейки. Класс Style предоставляет некоторые полезные свойства для работы с отображаемыми форматами чисел и дат.
Как использовать встроенные форматы чисел
Aspose.Cells предлагает некоторые встроенные форматы чисел для настройки отображаемых форматов чисел и дат. Эти встроенные форматы чисел могут быть применены с использованием свойства Number объекта Style. Все встроенные форматы чисел имеют уникальные числовые значения. Разработчики могут назначить любое желаемое числовое значение свойству 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 | 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.
- Список поддерживаемых форматов чисел
- Отображение пользовательского формата даты Шаблон g и ge mm dd
- Укажите пользовательские разделители десятичных и групповых чисел для рабочей книги
- Указание форматирования собственного шаблона DBNum