本文旨在解决Spring Boot应用中，尽管使用了@DateTimeFormat注解和Thymeleaf的#dates.format工具，日期在网页上仍显示包含hh:mm:ss时间部分的问题。我们将探讨问题根源，并提供两种解决方案：利用Thymeleaf的内置格式化功能实现精确控制，以及针对已包含时间字符串的快速截取方法，并给出相应的代码示例和最佳实践建议。
理解日期时间格式化问题
在Spring Boot和Thymeleaf的开发实践中，开发者经常会遇到日期对象在前端显示时，意外地包含了时间（hh:mm:ss）部分。即使已经尝试使用@DateTimeFormat(pattern = "yyyy-MM-dd")注解或Thymeleaf的#dates.format工具，问题依然存在。
出现这种现象的原因可能包括：
- @DateTimeFormat 的作用误解： DateTimeFormat注解主要用于将HTTP请求参数（如表单提交）中的字符串日期解析成java.util.Date对象，或在视图层将Date对象格式化为字符串用于输入字段的默认值。它通常不直接控制Thymeleaf模板中th:text的最终输出格式。
- 数据源问题： 传入Thymeleaf模板的日期变量（例如row.dateNaissance）可能已经是一个包含了时间部分的字符串，而不是一个纯粹的java.util.Date或java.time.LocalDate对象。在这种情况下，#dates.format函数可能无法正确解析和格式化这个字符串，或者它被跳过了。
- 默认 toString() 行为： 如果Thymeleaf变量未经明确格式化，或者在某些情况下，Java对象被隐式地调用了toString()方法，java.util.Date的默认toString()输出通常会包含完整的日期和时间信息（例如Tue Jul 07 00:00:00 CST 2050或2050-07-07 00:00:00.0）。
根据提供的截图和描述，问题很可能出在传入Thymeleaf的变量已经是一个形如2050-07-07 00:00:00.0的字符串，导致#dates.format未能生效，或者该字符串被直接显示。
解决方案一：利用Thymeleaf的日期格式化功能（推荐）
这是处理日期显示最标准、最推荐的方法。它要求传递给Thymeleaf的变量是一个java.util.Date或java.time.LocalDate/LocalDateTime对象。
-
确保后端传递的是日期对象： 在Spring MVC控制器中，确保你添加到模型（Model）中的日期变量是java.util.Date或java.time.LocalDate类型，而不是已经格式化好的字符串。
import java.util.Date; import java.time.LocalDate; // For modern Java Date/Time API // ... public String showPage(Model model) { // 假设 row.dateNaissance 是一个 Date 对象 Date dateFinContrat = new Date(); // 示例：当前日期时间 // 或者使用 LocalDate LocalDate localDate = LocalDate.now(); model.addAttribute("dateFinContrat", dateFinContrat); model.addAttribute("localDate", localDate); // ... return "yourTemplate"; } -
在Thymeleaf模板中正确使用 #dates.format： 使用#dates.format工具函数，并指定所需的日期格式模式。
Date Formatting Example 合同结束日期
格式化日期 (dd/MM/yyyy):
格式化日期 (yyyy-MM-dd):
本地日期
格式化本地日期 (dd-MM-yyyy):
- 对于java.util.Date对象，使用#dates.format(dateVariable, 'pattern')。
- 对于java.time包下的日期时间对象（如LocalDate, LocalDateTime），应使用#temporals.format(temporalVariable, 'pattern')。
- 常用的日期格式模式包括：
- yyyy-MM-dd：2023-01-15
- dd/MM/yyyy：15/01/2023
- MMMM dd, yyyy：January 15, 2023
解决方案二：针对已包含时间的字符串进行截取（快速修复）
如果无法改变后端传递的数据类型，或者row.dateNaissance确实是一个已经包含了时间部分的字符串（例如"2050-07-07 00:00:00.0"），并且你只需要显示日期部分，可以通过字符串操作来截取。这种方法通常作为快速修复或在数据源难以控制时的权宜之计。
根据问题的描述，输出格式为2050-07-07 00:00:00.0，其中日期和时间之间有一个空格。最直接的方法是在Java后端进行字符串分割。
import java.util.Date;
import java.text.SimpleDateFormat;
// ...
public String showPage(Model model) {
// 假设这是从某个地方获取到的原始字符串，例如从数据库中读取
String fullDateTimeString = "2050-07-07 00:00:00.0";
// 通过空格分割字符串，取第一个部分（日期部分）
String dateOnlyString = fullDateTimeString.split(" ")[0]; // 结果: "2050-07-07"
model.addAttribute("dateFinContratString", dateOnlyString);
// ...
return "yourTemplate";
}然后在Thymeleaf模板中直接显示这个截取后的字符串：
String Truncation Example
合同结束日期 (字符串截取)
日期:
注意事项：
- 这种方法假定日期和时间总是通过一个空格分隔。如果格式不固定，可能会出现问题。
- 这只是将一个字符串截断，而不是对日期对象进行格式化。如果后续需要对日期进行其他操作（如比较、计算），最好还是将其转换回日期对象。
注意事项与最佳实践
- 数据类型一致性： 始终优先在后端传递java.util.Date或java.time.LocalDate对象给前端，而不是预格式化的字符串。这能保持数据的语义完整性，并允许前端灵活地进行格式化。
- 使用 java.time API： 现代Java（Java 8及更高版本）推荐使用java.time包中的LocalDate、LocalDateTime、ZonedDateTime等类来处理日期和时间。它们提供了更清晰、更强大的API，并且是线程安全的。在Thymeleaf中，可以使用#temporals工具函数来格式化这些对象。
- 后端统一格式化： 如果前端的所有日期显示都需要一种特定格式，可以在后端通过@JsonFormat注解（用于RESTful API）或SimpleDateFormat（用于传统Web应用）将日期对象序列化为所需格式的字符串，但这通常不如在前端使用#dates.format灵活。
- 国际化 (I18n)： 如果你的应用需要支持多种语言和地区，Thymeleaf的#dates.format和#temporals.format也支持根据Locale进行格式化，以适应不同地区的日期显示习惯。
总结
解决Spring/Thymeleaf中日期显示多余时间的问题，核心在于理解日期对象的生命周期和格式化时机。最推荐的方法是确保后端传递的是日期对象，并在Thymeleaf模板中使用#dates.format（针对java.util.Date）或#temporals.format（针对java.time对象）进行精确控制。当遇到已包含时间部分的字符串时，可以采用字符串截取的快速修复方案，但应将其视为权宜之计，并尽可能优化数据源，使其传递正确的日期对象。遵循这些最佳实践，可以确保日期在Web页面上以预期的格式清晰展示。
