JavaFX应用使用jpackage打包后日期本地化失效的解决方案

本文旨在解决javafx应用程序在使用jpackage打包成独立可执行文件后，日期格式化中的本地化信息（如星期名称）丢失的问题。尽管代码中明确设置了locale，但打包后的应用可能默认不包含完整的本地化数据。核心解决方案是在jpackage命令中显式添加`jdk.localedata`模块，以确保所有必要的语言环境数据都被包含在最终的安装包中。

JavaFX应用日期本地化在打包后失效

许多JavaFX开发者在IDE中运行应用程序时，会发现日期和时间格式化功能（例如，使用DateTimeFormatter结合Locale来显示特定语言的星期名称）能够正常工作。然而，当使用jpackage工具将应用打包成独立的可执行文件（如.exe）后，这些本地化信息可能会意外地变回默认的英文显示，即使代码中已明确指定了非英文的Locale。这通常体现在TableCell中日期列的显示上，例如，期望显示西班牙语的星期名称，却最终显示为英文。

核心问题与原因分析

这种现象的根本原因在于jpackage在创建自包含应用程序时，为了减小包体积，默认情况下不会包含所有JDK的本地化数据。java.time包（及其DateTimeFormatter）在进行本地化格式化时，需要依赖这些特定的语言环境数据。当这些数据缺失时，系统会回退到默认的语言环境（通常是英文），导致日期中的星期名称等本地化元素显示不正确。

立即学习“Java免费学习笔记（深入）”；

为了确保应用程序能够正确地处理多种语言环境的日期和时间格式，需要显式地将包含这些本地化数据的jdk.localedata模块添加到打包过程中。

jpackage命令的优化

解决此问题的关键在于修改jpackage命令，显式地引入jdk.localedata模块。该模块包含了JDK支持的所有语言环境数据，确保DateTimeFormatter能够根据指定的Locale正确地进行本地化处理。

原始的jpackage命令示例：

Vizard

AI驱动的视频编辑器

101 查看详情

jpackage --type exe --input . --dest . --main-jar .Dulceria.jar --main-class com.example.dulceria.HelloApplication --module-path "D:Program FilesJavajavafx-jmods-18" --add-modules javafx.controls,javafx.fxml,java.sql,java.sql.rowset --win-shortcut --win-menu

修改后的jpackage命令，增加了jdk.localedata模块：

jpackage --type exe --input . --dest . --main-jar .Dulceria.jar --main-class com.example.dulceria.HelloApplication --module-path "D:Program FilesJavajavafx-jmods-18" --add-modules javafx.controls,javafx.fxml,java.sql,java.sql.rowset,jdk.localedata --win-shortcut --win-menu

通过在–add-modules参数中加入jdk.localedata，jpackage会将其包含在最终的运行时镜像中，从而解决本地化数据缺失的问题。

JavaFX日期格式化代码示例

以下是JavaFX应用程序中用于设置日期列本地化格式的代码片段，它展示了如何明确指定Locale来格式化日期：

import javafx.scene.control.TableCell;import javafx.scene.control.TableColumn;import java.time.LocalDate;import java.time.LocalTime;import java.time.format.DateTimeFormatter;import java.util.Locale;public class DateFormatterExample {    // 假设 Col_FEentrega 和 Col_Hora_entrega 是 TableColumn 和 TableColumn    private TableColumn