为什么阿里巴巴要求日期格式化时必须有使用y表示年,而不能用Y?

简介: 这一篇文章来介绍一个和SimpleDateFormat有关,很容易被忽视,而一旦忽视可能导致大故障的问题。

作者 | Hollis

在Java中进行日期处理大家一定都不陌生,我们经常会需要在代码中进行日期的转换、日期的格式化等操作。

而一般我们进行日期格式化的时候都会使用SimpleDateFormat工具,之前我们有一篇文章介绍过SimpleDateFormat的线程安全问题,这一篇文章再来介绍一个和SimpleDateFormat有关,很容易被忽视,而一旦忽视可能导致大故障的问题。

SimpleDateFormat

SimpleDateFormat是Java提供的一个格式化和解析日期的工具类。它允许进行格式化(日期 -> 文本)、解析(文本 -> 日期)和规范化。SimpleDateFormat 使得可以选择任何用户定义的日期-时间格式的模式。

在Java中,可以使用SimpleDateFormat的format方法,将一个Date类型转化成String类型,并且可以指定输出格式。

// Date转String
Date data = new Date();
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String dataStr = sdf.format(data);
System.out.println(dataStr);

以上代码,转换的结果是:2018-11-25 13:00:00,日期和时间格式由”日期和时间模式”字符串指定。如果你想要转换成其他格式,只要指定不同的时间模式就行了。

在Java中,可以使用SimpleDateFormat的parse方法,将一个String类型转化成Date类型。

// String转Data
System.out.println(sdf.parse(dataStr));

日期和时间模式表达方法

在使用SimpleDateFormat的时候,需要通过字母来描述时间元素,并组装成想要的日期和时间模式。常用的时间元素和字母的对应表(JDK 1.8)如下:
image.png
模式字母通常是重复的,其数量确定其精确表示。如前面我们用过的”yyyy-MM-dd HH:mm:ss”。我们知道其中的y其实是year的缩写,所以我们都知道使用y来表示年,默认情况下,我们都会使用y而不是Y,那么这两者之间有何区别呢?一旦用错了会带来什么后果呢?

其实在规定中,y表示year,而Y表示Week Year!

什么是Week Year

我们知道,不同的国家对于一周的开始和结束的定义是不同的。如在中国,我们把星期一作为一周的第一天,而在美国,他们把星期日作为一周的第一天。

同样,如何定义哪一周是一年当中的第一周?这也是一个问题,有很多种方式。

比如下图是2019年12月-2020年1月的一份日历。
image.png
到底哪一周才算2020年的第一周呢?不同的地区和国家,甚至不同的人,都有不同的理解。

  • 1、1月1日是周三,到下周三(1月8日),这7天算作这一年的第一周。
  • 2、因为周日(周一)才是一周的第一天,所以,要从2020年的第一个周日(周一)开始往后推7天才算这一年的第一周。
  • 3、因为12.29、12.30、12.31是2019年,而1.1、1.2、1.3才是2020年,而1.4周日是下一周的开始,所以,第一周应该只有1.1、1.2、1.3这三天。

ISO 8601

因为不同人对于日期和时间的表示方法有不同的理解,于是,大家就共同制定了了一个国际规范:ISO 8601 。

国际标准化组织的国际标准ISO 8601是日期和时间的表示方法,全称为《数据存储和交换形式·信息交换·日期和时间的表示方法》。

在 ISO 8601中。对于一年的第一个日历星期有以下四种等效说法: 1,本年度第一个星期四所在的星期; 2,1月4日所在的星期; 3,本年度第一个至少有4天在同一星期内的星期; 4,星期一在去年12月29日至今年1月4日以内的星期;

根据这个标准,我们可以推算出:
2020年第一周:2019.12.29-2020.1.4
所以,根据ISO 8601标准,2019年12月29日、2019年12月30日、2019年12月31日这两天,其实不属于2019年的最后一周,而是属于2020年的第一周。
JDK针对ISO 8601提供的支持
根据ISO 8601中关于日历星期和日表示法的定义,2019.12.29-2020.1.4是2020年的第一周。

我们希望输入一个日期,然后程序告诉我们,根据ISO 8601中关于日历日期的定义,这个日期到底属于哪一年。

比如我输入2019-12-20,他告诉我是2019;而我输入2019-12-30的时候,他告诉我是2020。

为了提供这样的数据,Java 7引入了「YYYY」作为一个新的日期模式来作为标识。使用「YYYY」作为标识,再通过SimpleDateFormat就可以得到一个日期所属的周属于哪一年了。

所以,我们通过代码可以验证:

public class WeekYearTest {

    public static void main(String[] args) {

        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
        SimpleDateFormat sdf1 = new SimpleDateFormat("YYYY");
        System.out.println(sdf1.format(sdf.parse("2019-12-01")));
        System.out.println(sdf1.format(sdf.parse("2019-12-30")));
        System.out.println(sdf1.format(sdf.parse("2020-01-01")));
    }
}

输出结果为:

2019
2020
2020

可见, 2019-12-30日因为属于2020年的第一周,所以返回的年份是2020年。

而如果将「YYYY」改成「yyyy」的话,输出结果就为:

2019
2019
2020

因为有这样的情况,所以我们日常开发的时候,如果把y写成了Y,那就可能导致日期输出的结果不符合我们的预期。

当我们要表示日期的时候,一定要使用 yyyy-MM-dd 而不是 YYYY-MM-dd ,这两者的返回结果大多数情况下都一样,但是极端情况就会有问题了。

而这一个要求,在《阿里巴巴Java开发手册》中也有类似的规定:
image.png
好啦,大家快去排查下你的代码,有没有’YYYY-MM-dd’这种形式的代码吧,如果有的话,一定要改掉哦!~

相关文章
|
SQL 缓存 Oracle
为什么阿里巴巴禁止使用 count(列名)或 count(常量)来替代 count(*)
本文介绍了COUNT函数的用法,主要用于统计表行数。主要用法有COUNT(*)、COUNT(字段)和COUNT(1)。
12943 0
为什么阿里巴巴禁止使用 count(列名)或 count(常量)来替代 count(*)
|
8月前
|
存储 弹性计算 安全
阿里云服务器ECS计算型c9i实例规格族怎么样?看看官方文档怎么说!
阿里云ECS计算型c9i实例基于全新CIPU架构,搭载Intel® Xeon® 6处理器(P-core),主频3.2GHz/全核睿频3.6GHz,提供稳定算力、强劲I/O与芯片级安全。适用于机器学习推理、视频编码、科学计算等高性能场景,支持NVMe、eRDMA、vTPM等特性。
282 10
|
8月前
|
消息中间件 分布式计算 Kafka
别被“结构化”骗了:聊聊 Spark Structured Streaming 的原理与那些年我踩过的坑
别被“结构化”骗了:聊聊 Spark Structured Streaming 的原理与那些年我踩过的坑
427 4
|
5月前
|
算法 Java PHP
PHP的垃圾回收机制
// 先不要问为什么非要加mt_rand,不然,绝笔说不过来了,到处都是坑
149 1
|
5月前
|
机器学习/深度学习 缓存 搜索推荐
Java+AI实战:从零构建智能推荐系统(一)
教程来源 https://tmywi.cn/category/jiankang.html 本文详解如何用Java从零构建生产级智能推荐系统SmartRec,覆盖数据采集、特征工程、多路召回、深度排序、重排及A/B测试全链路。聚焦高并发、实时性与可扩展性,助你掌握AI落地核心能力。
|
JavaScript 安全
在 Vue 中,如何在回调函数中正确使用 this?
在 Vue 中,如何在回调函数中正确使用 this?
674 0
|
消息中间件 Linux 数据中心
Docker核心技术:Docker原理之Namespace
通过以上内容,您可以深入了解Docker中的Namespace机制及其在资源隔离中的应用,从而更好地理解和应用Docker技术。
734 25
|
关系型数据库 MySQL 数据库
[图解MySQL]MySQL组提交(group commit)
[图解MySQL]MySQL组提交(group commit)
19141 0
|
缓存 安全 Java
Java中线程池,你真的会用吗?
本文我们就来围绕这个问题来分析一下为什么JDK自身提供的构建线程池的方式并不建议使用?到底应该如何创建一个线程池呢?
10431 123
Java中线程池,你真的会用吗?
|
关系型数据库 MySQL 定位技术
数据库中有哪些索引类型?
【7月更文挑战第2天】数据库中有哪些索引类型?
701 8

热门文章

最新文章