Como definir formatos de dados de células em C# com IronXL

Como faço para definir formatos de dados de células no Excel?

A propriedade FormatString pode ser acessada tanto por meio de células quanto de intervalos. Portanto, é possível definir formatos de dados para células, colunas, linhas individuais e qualquer intervalo selecionado. Essa flexibilidade torna o IronXL particularmente poderoso quando você precisa trabalhar com arquivos do Excel em C# sem interoperabilidade .

A formatação de dados é essencial para apresentar informações de forma clara em planilhas. Seja na criação de relatórios financeiros com valores monetários, dados científicos com casas decimais precisas ou análises baseadas em datas, a formatação adequada garante que seus dados sejam legíveis e profissionais. O IronXL simplifica esse processo, fornecendo acesso direto ao mecanismo de formatação do Excel por meio de uma API simples.

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

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

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set the data format to 12300.00%
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Percent2;

// Set the data format to 123.0000
workSheet["A2"].Value = 123;
workSheet["A2"].FormatString = "0.0000";

// Set data display format to range
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"];

// Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss";

workBook.SaveAs("dataFormats.xlsx");

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

// Assign value as string
workSheet["A1"].StringValue = "4402-12";

Como faço para usar os formatos integrados no IronXL?

A biblioteca IronXL oferece uma variedade de cadeias de formato predefinidas que podem ser acessadas através da classe IronXl.Formatting.BuiltinFormats para formatar células do Excel. Isso permite personalizar a forma como os dados são exibidos em suas planilhas do Excel. Esses formatos integrados abrangem os cenários de negócios mais comuns e são compatíveis com todas as versões do Excel.

Ao criar planilhas programaticamente, aplicar uma formatação consistente é crucial para manter padrões profissionais em todos os seus documentos. A classe BuiltinFormats fornece mais de 30 padrões de formato pré-configurados que correspondem às opções de formatação padrão do Excel.

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

using IronXL;
using IronXL.Formatting;

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Use builtin formats
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Accounting0;

workBook.SaveAs("builtinDataFormats.xlsx");

Quais formatos de dados integrados estão disponíveis?

Para o tipo Duration, os valores de entrada são representados em dias. Por exemplo, 1 dia equivale a 24 horas, e 1,05 dias equivalem a 25 horas e 12 minutos. Isso é particularmente útil ao trabalhar com dados do Excel que envolvem controle de tempo ou gerenciamento de projetos. Aqui estão os tipos de formato disponíveis:

Qual a função de cada tipo de formato?

• General: Formato padrão exibindo números sem formatação específica.
• Duration1: Mostra a duração em minutos e segundos como "mm:ss."
• Duration2: Mostra a duração em horas, minutos e segundos como "[h]:mm:ss."
• Duration3: Mostra a duração em minutos, segundos e milissegundos como "mm:ss.0."
• Accounting0: Formato de contabilidade sem decimais, parênteses para negativos como "#,##0_);(#,##0)."
• Accounting0Red: Formato de contabilidade sem decimais, vermelho para negativos como "#,##0_);Red."
• Accounting2: Formato de contabilidade com dois decimais, parênteses para negativos como "#,##0.00;(#,##0.00)."
• Accounting2Red: Formato de contabilidade com dois decimais, vermelho para negativos como "#,##0.00_);Red."
• Time1: Formato de 12 horas com AM/PM como "h:mm AM/PM."
• Time2: Formato de 12 horas com segundos e AM/PM como "h:mm:ss AM/PM."
• Time3: Formato de 24 horas sem segundos como "h:mm."
• Time4: Formato de 24 horas com segundos como "h:mm:ss."
• ShortDate: Formato de data curta como "m/d/yy."
• ShortDateAndTime: Formato de data e hora curta como "m/d/yy h:mm."
• LongDate1: Data longa com mês, dia, ano como "d-mmm-yy."
• LongDate2: Data longa com dia e mês abreviado como "d-mmm."
• LongDate3: Data longa com mês abreviado e ano como "mmm-yy."
• Fraction1: Valores fracionários com um dígito como "# ?/?."
• Fraction2: Valores fracionários com dois dígitos como "# ??/??."
• Scientific1: Notação científica com um decimal como "##0.0E+0."
• Scientific2: Notação científica com dois decimais como "0.00E+00."
• Percent: Percentual sem decimais como "0%."
• Percent2: Percentual com dois decimais como "0.00%."
• Currency0: Moeda sem decimais, parênteses para negativos como "$#,##0_);($#,##0)."
• Currency0Red: Moeda sem decimais, vermelho para negativos como "$#,##0_);Red."
• Currency2: Moeda com dois decimais, parênteses para negativos como "$#,##0.00;($#,##0.00)."
• Currency2Red: Moeda com dois decimais, vermelho para negativos como "$#,##0.00_);Red."
• Thousands0: Números com separador de milhar, sem decimais como "#,##0."
• Thousands2: Números com separador de milhar, dois decimais como "#,##0.00."
• Number0: Números sem decimais como "0."
• Number2: Números com dois decimais como "0.00."
• Text: Formato de texto simples como "@."

A formatação de dados e a formatação de números no Excel controlam como números, datas, horas e outros dados são exibidos nas células, melhorando a legibilidade e garantindo a precisão dos dados. Com os formatos de dados, você pode apresentar informações em formatos específicos, como porcentagens ou moedas. Da mesma forma, os formatos de número permitem personalizar as casas decimais e as opções de exibição.

Como aplicar vários formatos a diferentes intervalos?

Em aplicações do mundo real, muitas vezes é necessário aplicar formatos diferentes a várias partes da planilha. Este exemplo demonstra a formatação de um relatório financeiro com múltiplos tipos de dados. Essa abordagem é particularmente útil ao exportar para o Excel em C# a partir de bancos de dados ou outras fontes de dados.

using IronXL;
using IronXl.Formatting;
using System;

// Create a financial report with multiple formats
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Headers
workSheet["A1"].Value = "Financial Report Q4 2023";
workSheet["A1"].Style.Font.Bold = true;

// Revenue section with currency formatting
workSheet["A3"].Value = "Revenue";
workSheet["B3"].Value = 2500000;
workSheet["B3"].FormatString = BuiltinFormats.Currency0;

// Growth percentage
workSheet["A4"].Value = "YoY Growth";
workSheet["B4"].Value = 0.157;
workSheet["B4"].FormatString = BuiltinFormats.Percent2;

// Date formatting
workSheet["A6"].Value = "Report Date";
workSheet["B6"].Value = DateTime.Now;
workSheet["B6"].FormatString = BuiltinFormats.LongDate1;

// Apply accounting format to expense columns
IronXl.Range expenseRange = workSheet["B8:B12"];
expenseRange.FormatString = BuiltinFormats.Accounting2Red;

// Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx");

using IronXL;
using IronXl.Formatting;
using System;

// Create a financial report with multiple formats
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Headers
workSheet["A1"].Value = "Financial Report Q4 2023";
workSheet["A1"].Style.Font.Bold = true;

// Revenue section with currency formatting
workSheet["A3"].Value = "Revenue";
workSheet["B3"].Value = 2500000;
workSheet["B3"].FormatString = BuiltinFormats.Currency0;

// Growth percentage
workSheet["A4"].Value = "YoY Growth";
workSheet["B4"].Value = 0.157;
workSheet["B4"].FormatString = BuiltinFormats.Percent2;

// Date formatting
workSheet["A6"].Value = "Report Date";
workSheet["B6"].Value = DateTime.Now;
workSheet["B6"].FormatString = BuiltinFormats.LongDate1;

// Apply accounting format to expense columns
IronXl.Range expenseRange = workSheet["B8:B12"];
expenseRange.FormatString = BuiltinFormats.Accounting2Red;

// Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx");

Este exemplo mostra como diferentes tipos de formato se combinam para criar documentos financeiros profissionais. Para opções de formatação mais avançadas, incluindo formatação condicional , você pode expandir ainda mais esses conceitos.

Ao trabalhar com grandes conjuntos de dados ou criar relatórios programaticamente, a formatação consistente torna-se fundamental. O sistema de formatação do IronXL integra-se perfeitamente com outros recursos, como funções matemáticas e edição de fórmulas , permitindo que você crie soluções de relatórios totalmente automatizadas.

Para desenvolvedores que estão migrando do Office Interop ou buscando melhor desempenho, o sistema de formatação do IronXL oferece uma vantagem significativa. Ao contrário das abordagens tradicionais, você pode formatar milhares de células de forma eficiente, sem a sobrecarga de interoperabilidade COM. Para saber mais sobre as melhores práticas de automação do Excel, explore nossa documentação completa do Excel .