Freemarker中Date转String报错解决方案及常用语法整理

"在处理Word文档时遇到日期转换问题" 在Java开发中，我们经常需要从数据库中获取数据并使用FreeMarker模板引擎来生成报告或其他文档，如Word文档。当数据库中的字段类型是日期（Date），而在FreeMarker模板中尝试直接使用这个日期值时，可能会遇到“Can't convert the date-like value to string because it isn’t known if it’s a date (no time part), time or date-time value.”的错误。这是因为FreeMarker无法确定日期值是否包含时间部分，从而无法直接将其转换为字符串。 要解决这个问题，我们需要明确地将Date类型转换为String类型。在FreeMarker中，可以使用`?string`操作符来实现这个转换。例如，如果你有一个名为`xxx`的Date对象，原来的写法是`${xxx}`，现在应该修改为`${(xxx)?string("yyyy-MM-dd")}`。这会将日期格式化为“年-月-日”的形式。 以下是FreeMarker中处理不同情况的一些关键点： 1. **判断对象是否存在**: FreeMarker使用`?`操作符来检查对象是否为null。例如，`<#if target??>`表示如果`target`不为null，则执行后续代码。 2. **字符串或数字比较**: 在FreeMarker中，字符串比较可以直接使用`=`, `!=`等运算符，与Java中的`.equals()`方法不同。 3. **判断列表长度**: 要检查一个列表（List）的长度，可以使用`?size`属性，如`<#if fields?size > 0>`来判断列表是否为空。 4. **截取字符串长度**: 如果需要限制显示的字符串长度，可以使用`?length`和切片操作。例如，`<#if infos.name?length < 7>`表示如果名字长度小于7，则显示完整的名称；否则，只显示前6个字符。 5. **时间格式化**: - 时间戳转日期：`${time?number_to_datetime}`将时间戳转换为日期对象。 - 日期格式化：使用`?string`操作符结合特定格式，如`'yyyy-MM-dd hh:mm:ss'`或`'yyyy-MM-dd'`，将日期对象转换为指定格式的字符串。 6. **数值格式化**: - Freemarker提供了货币（currency）、百分比（percent）和普通数字（number）的格式化。例如，`${0.3?string.currency}`会将0.3格式化为货币形式，`${0.3?string.percent}`会转换为百分比。 了解这些基本操作，可以帮助你更有效地在FreeMarker模板中处理日期、字符串和其他数据类型，避免遇到类似的转换错误。在处理Word文档或任何其他基于FreeMarker的文档生成时，确保正确地转换和格式化数据是至关重要的。