1. IronXL
2. Cómo Hacer
3. Establecer formatos de datos de celda

Cómo configurar los formatos de datos de las celdas

por Chaknith Bin

El formato de datos y números en Excel permite controlar cómo se muestran los números, fechas, horas y otros datos en las celdas, mejorando la legibilidad y garantizando la precisión de los datos. Con los formatos de datos, puede presentar la información en formatos específicos como porcentajes o divisas. Del mismo modo, los formatos numéricos permiten personalizar los decimales y las opciones de visualización.

La librería IronXL le permite establecer el formato de los datos o de los números en C#. Esta biblioteca simplifica el proceso de creación, formateo y manipulación de archivos Excel mediante programación, lo que la convierte en una valiosa herramienta para tareas de tratamiento y presentación de datos en aplicaciones C#.

Instalar con NuGet

Install-Package IronXL.Excel

nuget.org/packages/IronXL.Excel/

o

Descargar DLL

Descargar DLL

Instalar manualmente en su proyecto

Establecer Formatos de Datos de Celda Ejemplo

Se puede acceder a la propiedad FormatString tanto a través de celdas como de rangos. Por lo tanto, es posible establecer formatos de datos para celdas individuales, columnas, filas y cualquier rango seleccionado.

:path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format.cs

using IronXL;
using IronXL.Formatting;
using System;
using System.Linq;

//  Crear un nuevo libro de trabajo
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

//  Ajuste el formato de los datos a 12300.00%.
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Percent2;

//  Ajuste el formato de los datos a 123.0000
workSheet["A2"].Value = 123;
workSheet["A2"].FormatString = "0.0000";

//  Establecer el formato de visualización de datos en rango
DateTime dateValue = new DateTime(2020, 1, 1, 12, 12, 12);
workSheet["A3"].Value = dateValue;
workSheet["A4"].Value = new DateTime(2022, 3, 3, 10, 10, 10);
workSheet["A5"].Value = new DateTime(2021, 2, 2, 11, 11, 11);

IronXL.Range range = workSheet["A3:A5"];

//  Ajuste el formato de los datos a 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss";

workBook.SaveAs("dataFormats.xlsx");

Imports IronXL
Imports IronXL.Formatting
Imports System
Imports System.Linq

'  Crear un nuevo libro de trabajo
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

'  Ajuste el formato de los datos a 12300.00%.
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Percent2

'  Ajuste el formato de los datos a 123.0000
Private workSheet("A2").Value = 123
Private workSheet("A2").FormatString = "0.0000"

'  Establecer el formato de visualización de datos en rango
Private dateValue As New DateTime(2020, 1, 1, 12, 12, 12)
Private workSheet("A3").Value = dateValue
Private workSheet("A4").Value = New DateTime(2022, 3, 3, 10, 10, 10)
Private workSheet("A5").Value = New DateTime(2021, 2, 2, 11, 11, 11)

Private range As IronXL.Range = workSheet("A3:A5")

'  Ajuste el formato de los datos a 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss"

workBook.SaveAs("dataFormats.xlsx")

Establecer valor de celda como cadena

Cuando establezca el valor en IronXL, utilice StringValue en lugar de Value para asignar directamente el valor exacto a la celda sin conversión automática. Este uso es similar a colocar un apóstrofo antes del valor de la celda en Excel.

:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-stringvalue.cs

//  Asignar valor como cadena
workSheet["A1"].StringValue = "4402-12";

'  Asignar valor como cadena
workSheet("A1").StringValue = "4402-12"

Ejemplo de uso de formatos incorporados

La biblioteca IronXL ofrece una variedad de cadenas de formato predefinidas a las que se puede acceder a través de la clase IronXL.Formatting.BuiltinFormats para formatear celdas de Excel, lo que le permite personalizar cómo se muestran los datos en sus hojas de cálculo de Excel.

:path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format-builtin-formats.cs

using IronXL;
using IronXL.Formatting;

//  Crear un nuevo libro de trabajo
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

//  Utilizar formatos incorporados
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Accounting0;

workBook.SaveAs("builtinDataFormats.xlsx");

Imports IronXL
Imports IronXL.Formatting

'  Crear un nuevo libro de trabajo
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

'  Utilizar formatos incorporados
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Accounting0

workBook.SaveAs("builtinDataFormats.xlsx")

Formatos de datos incorporados disponibles

Para el tipo Duración, los valores de entrada se representan en días. Por ejemplo, 1 día equivale a 24 horas, y 1,05 días a 25 horas y 12 minutos. Estos son los tipos de formato disponibles:

Descripción

• General: El formato por defecto que muestra los números tal y como son sin ningún formato específico.
• Duración1: Muestra valores de duración en minutos y segundos, como "mm:ss". Los números introducidos en la propiedad Valor se considerarán días.
• Duración2: Muestra los valores de duración en horas, minutos y segundos, como "[h]:mm:ss."
• Duración3: Muestra valores de duración en minutos, segundos y milisegundos, como "mm:ss.0".
• Contabilidad0: Formatea los valores contables sin dígitos decimales, utilizando paréntesis para valores negativos, como "#,##0_".);(#,##0)."
• Contabilidad0Rojo: Formatea los valores contables sin dígitos decimales, utilizando el color rojo para los valores negativos, como "#,##0_)"Rojo".
• Contabilidad2: Formatea los valores contables con dos dígitos decimales, utilizando paréntesis para valores negativos, como "#,##0.00";(#,##0.00)."
• Contabilidad2Rojo: Formatea los valores contables con dos dígitos decimales, utilizando el color rojo para los valores negativos, como "#,##0.00_)"Rojo".
• Hora1: Formatea los valores de la hora en formato de reloj de 12 horas con AM/PM, como "h:mm AM/PM".
• Hora2: Formatea los valores de la hora en formato de reloj de 12 horas con segundos y AM/PM, como "h:mm:ss AM/PM".
• Hora3: Formatea los valores de tiempo en formato de reloj de 24 horas sin segundos, como "h:mm".
• Hora4: Formatea los valores de tiempo en formato de reloj de 24 horas con segundos, como "h:mm:ss".
• FechaCorta: Formatea los valores de fecha en un formato corto, como "m/d/aa".
• FechaHoraCorta: Formatea los valores de fecha y hora en un formato corto, como "m/d/aa h:mm.".
• FechaLarga1: Formatea valores de fecha en un formato largo con mes, día y año, como "d-mmm-aa".
• FechaLarga2: Formatea los valores de fecha en un formato largo con día y mes abreviado, como "d-mmm".
• FechaLarga3: Formatea valores de fecha en un formato largo con mes y año abreviados, como "mmm-aa".
• Fracción1: Formatea valores fraccionarios con un dígito, como "# ?/?".
• Fracción2: Formatea valores fraccionarios con dos dígitos, como "# ??/??".
• Científico1: Formatea los números en notación científica con un dígito después del punto, como "##0.0E+0".
• Científico2: Formatea los números en notación científica con dos dígitos después del punto, como "0.00E+00".
• Porcentaje: Formatea valores porcentuales sin dígitos decimales, como "0%".
• Porcentaje2: Formatea valores porcentuales con dos dígitos decimales, como "0,00%".
• Moneda0: Formatea valores monetarios sin dígitos decimales, utilizando paréntesis para valores negativos, como "$#,##0_".);($#,##0)."
• Moneda0Rojo: Formatea valores monetarios sin dígitos decimales, utilizando el color rojo para valores negativos, como "$#,##0_)"Rojo".
• Moneda2: Formatea valores monetarios con dos dígitos decimales, usando paréntesis para valores negativos, como "$#,##0.00;($#,##0.00)."
• Moneda2Rojo: Formatea valores monetarios con dos dígitos decimales, utilizando el color rojo para valores negativos, como "$#,##0.00_)"Rojo".
• Miles0: Formatea números con separador de miles y sin dígitos decimales, como "#,##0".
• Miles2: Formatea números con separador de miles y dos cifras decimales, como "#,##0.00".
• Número0: Formatea números sin dígitos decimales, como "0".
• Número2: Formatea números con dos dígitos decimales, como "0.00".
• Texto: Formatea los valores de texto como texto plano, como "@" (no se aplica ningún formato específico).

Chaknith Bin

Ingeniero de software

Chaknith es el Sherlock Holmes de los desarrolladores. La primera vez que se le ocurrió que podría tener futuro en la ingeniería de software fue cuando hacía retos de código por diversión. Su trabajo se centra en IronXL e IronBarcode, pero se enorgullece de ayudar a los clientes con todos los productos. Chaknith aprovecha sus conocimientos, adquiridos hablando directamente con los clientes, para ayudar a mejorar los propios productos. Sus comentarios anecdóticos van más allá de los tickets de Jira y apoyan el desarrollo de productos, la documentación y el marketing, para mejorar la experiencia general del cliente.Cuando no está en la oficina, se le puede encontrar aprendiendo sobre aprendizaje automático, codificación y senderismo.