怎么通过 String.format() 的 %tF 占位符实现不依赖第三方库的日期格式化快捷输出

%tF 是 Ja va 里 `String.format()` 自带的一个日期格式化占位符，专门用来输出 `yyyy-MM-dd` 格式的日期字符串。最大的好处是——不需要额外引入任何第三方库，像 Joda-Time 或者 `ja va.time.format.DateTimeFormatter` 都用不上，非常适合快速、轻量的日期输出场景。

那这个 `%tF` 到底是怎么运作的？其实它是 `ja va.util.Formatter` 定义的“时间/日期转换”之一，属于一种复合转换：以 `%t` 开头，后面跟一个单独的格式字母。这里的 `F` 代表 ISO 8601 日期格式，也就是 `yyyy-MM-dd`。 它只接受日期类的参数，包括 `long`（毫秒时间戳）、`ja va.util.Date`、`ja va.util.Calendar`，还有 Ja va 8 引入的 `ja va.time.temporal.TemporalAccessor`（比如 `LocalDateTime`、`LocalDate` 这些）。这点需要注意，不是随便什么类型都能往里塞的。

基本用法示例

用法很简单，直接传入支持的时间对象就行： - `String.format("%tF", System.currentTimeMillis())` → 输出 `"2024-06-15"` - `String.format("%tF", new Date())` → 输出 `"2024-06-15"` - `String.format("%tF", LocalDate.now())` → 输出 `"2024-06-15"` - `String.format("%tF", LocalDateTime.now())` → 同样只取日期部分，输出 `"2024-06-15"` 可以看到，无论传入什么类型，最终输出的都是统一的 `yyyy-MM-dd` 格式，很省事。

注意事项与常见陷阱

有几个地方得特别留意。 **不支持自定义分隔符或局部格式**：`%tF` 固定输出 `yyyy-MM-dd`，没法改成 `yyyy/MM/dd` 或者 `dd.MM.yyyy`。如果你有这种需求，就得用 `%tY-%tm-%td` 手动拼，或者干脆上 `ja va.time.format.DateTimeFormatter`。 **时区敏感性取决于输入类型**： - 传 `long` 或 `Date`：按 JVM 的默认时区转成本地日期 - 传 `LocalDate`：没有时区概念，直接输出 - 传 `ZonedDateTime` 或 `Instant`：会先转换到系统默认时区，再取日期部分 **不能单独对字符串解析后格式化**：这一点很关键——`%tF` 不接受像 `"2024-01-01"` 这样的纯字符串。如果手头只有字符串，必须先解析（比如用 `LocalDate.parse()`），再传进去。

替代方案（当 %tF 不够用时）

如果 `%tF` 满足不了你的格式要求，又想避免引入第三方库，可以组合其他 `%t` 占位符： - `String.format("%tY年%tm月%td日", LocalDate.now())` → 输出 `"2024年06月15日"` - `String.format("%td/%tm/%tY", Calendar.getInstance())` → 输出 `"15/06/2024"` - `String.format("%tF %tR", new Date())` → 输出 `"2024-06-15 14:30"`（日期加 24 小时制时间） 写多参数格式化的时候要记住：所有 `%tX` 必须共用同一个时间参数，不能写成 `String.format("%tF", d1, "%tR", d2)`。每个 `%t` 都消耗一个参数，按顺序对应，这一点很容易踩坑。