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:
- Haga clic derecho en cualquier celda.
- 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
- Consulte el formato de número personalizado al configurar la propiedad Style.Custom
- Lista de formatos de número admitidos
- Renderizar formato personalizado de fecha del patrón g y ge mm dd
- Especificar separadores de números decimales y de grupo personalizados para el libro de trabajo
- Especificación de formato de patrón personalizado DBNum