在處理電子表格時，尤其是在專業(yè)和數(shù)據(jù)導(dǎo)向型環(huán)境中，正確設(shè)置 Excel 單元格內(nèi)的數(shù)字格式至關(guān)重要。恰當(dāng)?shù)臄?shù)字格式不僅能讓信息展示更加清晰和一致，還能根據(jù)其用途（如財(cái)務(wù)數(shù)據(jù)、百分比、日期或科學(xué)數(shù)值）確保其表現(xiàn)形式與數(shù)據(jù)性質(zhì)相符。利用 Java 進(jìn)行 Excel 任務(wù)自動化，程序化地設(shè)定合適的數(shù)字格式，能有效提升工作效率，降低出錯幾率，并增強(qiáng)報(bào)表或儀表盤的易讀性。本文將介紹如何使用 Spire.XLS for Java 設(shè)置 Excel 單元格的數(shù)字格式，幫助輕松創(chuàng)建精美且結(jié)構(gòu)清晰的電子表格。

Spire.XLS for.Java試用下載 

安裝 Spire.XLS for Java

首先，您需要在 Java 程序中添加 Spire.Xls.jar 文件作為依賴項(xiàng)。JAR 文件可以從此鏈接下載。 如果您使用 Maven，則可以將以下代碼添加到項(xiàng)目的 pom.xml 文件中，從而輕松地在應(yīng)用程序中導(dǎo)入 JAR 文件。

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>//repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.xls</artifactId>
        <version>14.12.0</version>
    </dependency>
</dependencies>

用 Java 設(shè)置 Excel 單元格的數(shù)字格式

Spire.XLS for Java 為開發(fā)者提供了 CellRange.setNumberFormat() 方法，允許開發(fā)者使用 Excel 的數(shù)字格式代碼為單元格設(shè)置數(shù)字顯示格式。下表列出了 Excel 數(shù)字格式代碼中常用的符號及其功能：

使用 Java 設(shè)置 Excel 單元格數(shù)字格式的詳細(xì)步驟如下：

• 創(chuàng)建一個 Workbook 對象。
• 使用 Workbook.getWorksheets().get() 方法獲取工作表。
• 使用 CellRange.setValue() 方法添加字符串到指定單元格，或使用 CellRange.setNumberValue() 方法添加數(shù)值到指定單元格。
• 使用 CellRange.setNumberFormat() 方法通過數(shù)字格式代碼設(shè)置單元格的數(shù)字格式。
• 使用 Workbook.saveToFile() 方法保存工作簿。

import com.spire.xls.*;

public class SetNumberFormat {
    public static void main(String[] args) {
        // 創(chuàng)建一個新的工作簿實(shí)例
        Workbook workbook = new Workbook();

        // 獲取第一個工作表
        Worksheet sheet = workbook.getWorksheets().get(0);

        // 添加標(biāo)題
        sheet.getCellRange("B1").setText("數(shù)字格式");
        sheet.getCellRange("B1").getCellStyle().getExcelFont().isBold(true);
        sheet.getCellRange("B1").getCellStyle().getExcelFont().setFontName("HarmonyOS Sans SC");
        sheet.getCellRange("B1:C1").merge();
        sheet.getCellRange("B1:C1").setHorizontalAlignment(HorizontalAlignType.Center);

        // 添加數(shù)字格式示例及對應(yīng)的值
        // 添加正數(shù)格式示例
        addNumberFormatExample(sheet, "B3", "C3", "0", "1234.5678"); // 格式為整數(shù)
        addNumberFormatExample(sheet, "B4", "C4", "0.00", "1234.5678"); // 格式為保留兩位小數(shù)
        addNumberFormatExample(sheet, "B5", "C5", "#,##0.00", "1234.5678"); // 格式為帶千位分隔符且保留兩位小數(shù)
        addNumberFormatExample(sheet, "B6", "C6", "$#,##0.00", "1234.5678"); // 格式為貨幣格式

        // 添加負(fù)數(shù)格式示例
        addNumberFormatExample(sheet, "B7", "C7", "0;[Red]-0", "-1234.5678"); // 格式為負(fù)數(shù)用紅色顯示
        addNumberFormatExample(sheet, "B8", "C8", "0.00;[Red]-0.00", "-1234.5678"); // 格式為保留兩位小數(shù)，負(fù)數(shù)用紅色顯示

        // 添加科學(xué)計(jì)數(shù)法和百分比格式示例
        addNumberFormatExample(sheet, "B9", "C9", "0.00E+00", "1234.5678"); // 格式為科學(xué)計(jì)數(shù)法
        addNumberFormatExample(sheet, "B10", "C10", "0.00%", "0.5678"); // 格式為百分比

        // 添加日期和時間格式示例
        addNumberFormatExample(sheet, "B11", "C11", "yyyy-MM-dd", "44930.0"); // Excel 日期值對應(yīng) 2023-01-01
        addNumberFormatExample(sheet, "B12", "C12", "HH:mm:ss", "0.75"); // Excel 時間值對應(yīng) 18:00:00

        // 添加文本格式示例
        addNumberFormatExample(sheet, "B13", "C13", "@", "文本示例"); // 格式為文本

        // 設(shè)置格式
        sheet.getCellRange("B3:B13").getCellStyle().setKnownColor(ExcelColors.Gray25Percent);
        sheet.getCellRange("C3:C13").getCellStyle().setKnownColor(ExcelColors.Gray50Percent);
        sheet.setColumnWidth(2, 24);
        sheet.setColumnWidth(3, 24);

        // 將工作簿保存到文件
        workbook.saveToFile("output/設(shè)置Excel單元格數(shù)字格式.xlsx", FileFormat.Version2016);
        workbook.dispose();
    }

    /**
     * 向工作表指定的單元格中添加數(shù)字格式示例
     *
     * @param sheet        要修改的工作表
     * @param textCell     顯示數(shù)字格式字符串的單元格
     * @param valueCell    顯示格式化值的單元格
     * @param format       數(shù)字格式代碼
     * @param value        要格式化的數(shù)值
     */
    private static void addNumberFormatExample(Worksheet sheet, String textCell, String valueCell, String format, String value) {
        sheet.getCellRange(textCell).setText(format); // 顯示數(shù)字格式代碼
        sheet.getCellRange(valueCell).setValue(value); // 添加數(shù)值
        // sheet.getCellRange(valueCell).setNumberValue(Double); // 或者使用 setNumberValue() 方法設(shè)置數(shù)值
        sheet.getCellRange(valueCell).setNumberFormat(format); // 應(yīng)用數(shù)字格式
    }
}

用 Java 在 Excel 單元格中添加帶數(shù)字格式的值

Spire.XLS for Java 支持通過 CellRange 類下的方法直接將帶有特定數(shù)字格式的數(shù)據(jù)添加到 Excel 單元格中。下表概述了將帶有常見數(shù)字格式的數(shù)據(jù)添加到單元格的方法及其描述：

向 Excel 單元格添加帶數(shù)字格式的值的詳細(xì)步驟如下：

• 創(chuàng)建 Workbook 類的實(shí)例。
• 使用 Workbook.getWorksheets().get() 方法獲取工作表。
• 使用 Worksheet.getCellRange() 方法獲取一個單元格或單元格范圍。
• 使用 CellRange 類下的方法添加特定數(shù)字格式的值。
• 根據(jù)需要設(shè)置單元格樣式。
• 使用 Workbook.saveToFile() 方法保存工作簿。

import com.spire.xls.*;

import java.util.Calendar;
import java.util.Date;

public class AddFormattedDataExcel {
    public static void main(String[] args) {
        // 創(chuàng)建一個新的工作簿實(shí)例
        Workbook workbook = new Workbook();

        // 獲取第一個工作表
        Worksheet sheet = workbook.getWorksheets().get(0);

        // 添加文本值
        sheet.getCellRange("C3").setText("示例文本");
        // 添加數(shù)值
        sheet.getCellRange("C4").setNumberValue(1234.5678);
        // 添加布爾值
        sheet.getCellRange("C5").setBooleanValue(true);
        // 添加日期時間值
        sheet.getCellRange("C6").setDateTimeValue(new Date(2024, Calendar.DECEMBER, 12));
        // 添加 HTML 字符串
        sheet.getCellRange("C7").setHtmlString("加粗文本");

        // 格式化單元格
        sheet.getCellRange("C3:C7").setHorizontalAlignment(HorizontalAlignType.Center);
        sheet.getCellRange("C3:C7").setVerticalAlignment(VerticalAlignType.Center);
        sheet.getCellRange("C3:C7").getCellStyle().getExcelFont().setSize(14);
        for (int i = 3; i <= 7; i++) {
            sheet.autoFitColumn(i);
        }

        // 保存工作簿
        workbook.saveToFile("output/添加帶數(shù)字格式的值到Excel.xlsx", FileFormat.Version2016);
        workbook.dispose();
    }
}

歡迎下載|體驗(yàn)更多E-iceblue產(chǎn)品