Configuraciones numéricas

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

Una característica muy fuerte 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 utilizarse para representar diferentes valores, incluidos decimales, moneda, porcentaje, fracción o valores contables, etc. Todos estos valores numéricos se muestran en diferentes formatos según el tipo de información que representan. De manera similar, hay muchos formatos en los que se puede mostrar una fecha u 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 tipo de 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 admite todos estos formatos de visualización.

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

Aspose.Cells proporciona métodos GetStyle y SetStyle para la clase Cell. Estos métodos se utilizan para obtener y establecer el formato de una celda. La clase Style proporciona algunas propiedades útiles para tratar con 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 integrados para configurar los formatos de visualización de los números y fechas. Estos formatos de números integrados se pueden aplicar utilizando la propiedad Number del objeto Style. Todos los formatos de números integrados tienen valores numéricos únicos. Los desarrolladores pueden asignar cualquier valor numérico deseado a la propiedad Number del objeto Style para aplicar el formato de visualización. Este enfoque es rápido. Los formatos de números integrados admitidos por Aspose.Cells se enumeran 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	@

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

Cómo utilizar formatos de números personalizados

Para definir su propia cadena de formato personalizada para establecer el formato de visualización, utilice la propiedad Style del objeto Custom. Este enfoque no es tan rápido como usar formatos preestablecidos, pero es más flexible.

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

Si utiliza la propiedad Custom para configurar el formato de número, cualquier formato anterior establecido usando la propiedad Number se anulará y viceversa.

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