Configuraciones numéricas

Cómo establecer formatos de visualización de números y fechas

Una función muy potente de Microsoft Excel es que permite a los usuarios establecer los formatos de visualización de valores numéricos y fechas. Sabemos que los datos numéricos pueden usarse para representar diferentes valores incluyendo decimal, moneda, porcentaje, fracción o valores de contabilidad, etc. Todos estos valores numéricos se muestran en diferentes formatos dependiendo del tipo de información que representan. De manera similar, existen muchos formatos en los que se puede mostrar una fecha o hora.
Aspose.Cells admite esta funcionalidad y permite a los desarrolladores establecer cualquier formato de visualización para un número o fecha.

Cómo establecer formatos de visualización en Microsoft Excel

Para establecer formatos de visualización en Microsoft Excel:

  1. Haga clic derecho en cualquier celda.
  2. Seleccione Formato de celdas. Aparecerá un cuadro de diálogo que se usa para establecer los formatos de visualización de cualquier valor.

En el lado izquierdo del cuadro de diálogo, hay muchas categorías de valores como General, Número, Moneda, Contabilidad, Fecha, Hora, Porcentaje, etc. Aspose.Cells soporta todos estos formatos de visualización.

Aspose.Cells proporciona un módulo, Workbook que representa un archivo de Excel. El módulo Workbook contiene una colección Worksheets que permite acceder a cada hoja en el archivo de Excel. Una hoja de cálculo está representada por el módulo Worksheet. El módulo Worksheet proporciona una colección Cells. Cada elemento en la colección Cells representa un objeto del módulo Cell.

Aspose.Cells ofrece métodos getStyle() y setStyle(Style) para el módulo Cell. Estos métodos se usan para obtener y establecer el formato de una celda. El módulo Style proporciona algunas propiedades útiles para tratar los formatos de visualización de números y fechas.

Cómo utilizar los formatos de números integrados

Aspose.Cells ofrece algunos formatos de números incorporados para configurar los formatos de visualización de los números y fechas. Estos formatos pueden aplicarse usando el método setNumber(number) del objeto Style. Todos los formatos de números incorporados tienen valores numéricos únicos. Los desarrolladores pueden asignar cualquier valor numérico deseado al método setNumber(number) del objeto Style para aplicar el formato de visualización. Este método es rápido. Los formatos de números incorporados soportados por Aspose.Cells se listan a continuación.

Valor Tipo Cadena de formato
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);

Cómo utilizar formatos de números personalizados

Para definir tu propia cadena de formato personalizada para establecer el formato de visualización, usa el método setCustom(string) del objeto Style. Este método no es tan rápido como usar formatos predefinidos, pero es más flexible.

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

Temas avanzados