0

0

什么是DateTimeFormatter类_Java 8新日期格式化工具的线程安全优势

P粉602998670

P粉602998670

发布时间:2026-02-16 12:42:50

|

200人浏览过

|

来源于php中文网

原创

datetimeformatter 是线程安全的,应定义为 static final 常量复用;它不可变、无共享状态,pattern 大小写敏感且不兼容 simpledateformat;默认严格解析,需显式设置 lenient 模式;解析带时区字符串应使用 zoneddatetime/offsetdatetime。

什么是datetimeformatter类_java 8新日期格式化工具的线程安全优势

DateTimeFormatter 是线程安全的,别再 new 它了

它内部状态不可变,所有方法返回新实例,没有共享可变字段。这意味着你可以放心地把一个 DateTimeFormatter 实例设为 static final,在多线程环境下复用,完全不用加锁或每次重建。

常见错误是每次格式化都写 new DateTimeFormatter.ofPattern("yyyy-MM-dd") —— 这不仅浪费对象创建开销,还掩盖了它本可复用的本质。

  • 推荐做法:定义成常量,比如
    public static final DateTimeFormatter YYYY_MM_DD = DateTimeFormatter.ofPattern("yyyy-MM-dd");</li>
    <li>不要在循环里反复调用 <code>ofPattern()
    ofLocalizedDate(),它们每次都会新建对象
  • 注意:withZone()withLocale() 等方法也返回新实例,原实例不受影响,所以依然安全

pattern 字符大小写敏感,且不支持旧版 SimpleDateFormat 的全部符号

比如 yyyyYYYY 含义不同:yyyy 是“年份”,YYYY 是“基于周的年”(week year),跨年时可能差一年;MM 是月,mm 是分钟,写反会导致解析出错或静默错误。

更隐蔽的问题是,DateTimeFormatter 不识别 SSS 以外的毫秒符号(比如不支持 sss),也不支持 EEEE 以外的星期全称写法(EEE 是缩写,EEEE 是全称),而且不兼容 SimpleDateFormatZZ(RFC 822 格式时区)——得用 xxxXX

立即学习Java免费学习笔记(深入)”;

今天学点啥
今天学点啥

秘塔AI推出的AI学习助手

下载
  • 校验 pattern 的最简单办法:立刻调用 parse() 试一个已知字符串,别等上线后报 DateTimeParseException
  • 中文环境务必显式传 Locale.CHINA,否则 ofLocalizedDate(FormatStyle.FULL) 可能返回英文星期/月份
  • DateTimeFormatter.ISO_LOCAL_DATE 这类预定义常量不含时区,解析带 Z+08:00 的字符串会直接抛异常

解析字符串时,lenient 模式默认关闭,严格模式容易爆 DateTimeParseException

SimpleDateFormat 默认宽松不同,DateTimeFormatter 默认严格校验:少一位数字、多一个空格、年份超出范围(如 99999),都会直接抛 DateTimeParseException,而不是尝试容错。

这不是 bug,是设计选择。但很多老代码迁移到 Java 8 时没意识到这点,结果原来能 parse 的字符串突然失败。

  • 若需宽松行为,必须显式调用 withResolverStyle(ResolverStyle.LENIENT),但要注意:LENIENT 不等于 forgiving,它只对日历计算做宽松(比如把 2 月 30 日转成 3 月 2 日),不处理格式错位
  • 更稳妥的做法是先用正则或 String.trim() 清洗输入,再进 parse(),而不是依赖解析器兜底
  • 捕获异常时别只打日志,记得看 e.getParsedString()e.getErrorIndex(),能快速定位哪一截格式不对

自定义 formatter 要小心 withZone() 和 withLocale() 的链式调用顺序

withZone()withLocale() 都返回新 formatter,但它们不改变原始实例。问题常出在链式调用时误以为“设置了时区就自动带上 locale”,其实没有。

比如 DateTimeFormatter.ofPattern("HH:mm:ss").withZone(ZoneId.of("Asia/Shanghai")).withLocale(Locale.US) 是合法的,但如果你漏掉 withLocale(),又用了 EEEE 这种依赖 locale 的 pattern,运行时就会按默认 locale(通常是系统 locale)解释星期名,导致解析失败。

  • 建议把 withLocale() 放在链式调用最前面,避免后续 pattern 解析依赖未设置的 locale
  • withZone() 只影响格式化输出(比如 format() 时转成指定时区时间),不影响解析 —— 解析永远以字符串自带时区或默认时区为准
  • 如果要解析带时区的字符串(如 "2024-01-01T12:00:00+08:00"),别用 LocalDateTime.parse(),改用 ZonedDateTime.parse()OffsetDateTime.parse()

真正难的不是记住哪些方法可用,而是理解每个配置项生效的边界:pattern 决定字符匹配规则,locale 决定文本含义,zone 决定时间上下文,resolver style 决定容错尺度——这四个维度一旦混用或遗漏,错误往往不报在调用点,而藏在下游的时间计算里。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

750

2023.08.02

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1552

2023.10.24

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

865

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

446

2024.06.27

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

552

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

216

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1552

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

640

2023.11.24

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

145

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 3.6万人学习

C# 教程
C# 教程

共94课时 | 9.5万人学习

Java 教程
Java 教程

共578课时 | 66.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号