1.5 日期时间

1

【强制】在日期格式化时，传入pattern 中表示年份统一使用小写的y。

​说明：在日期格式化时，yyyy 表示当天所在的年，大写的YYYY 表示week in which year（JDK 7 之后引入的概念），意思是当天所在的周属于的年份。一周从周日开始，周六结束，只要本周跨年，返回的YYYY 就是下一年。​

正例：表示日期和时间的格式如下所示：

new SimpleDateFormat("yyyy-MM-dd HH:mm:ss")

2

【强制】在日期格式中，分清楚大写的M 和小写的m、大写的H和小写的h 分别代表的意义。

​说明：日期格式中的这两对字母表意如下：​

​1）表示月份，用大写的M；​

​2）表示分钟，用小写的m；​

​3）表示24 小时制，用大写的H；​

​4）表示12 小时制，用小写的h。​

3

【强制】获取当前毫秒数：是System.currentTimeMillis();而不是new Date().getTime()。

​说明：如果想获取更加精确的纳秒级时间值，则使用System.nanoTime 的方式。在JDK 8 中，针对统计时间等场景，推荐使用Instant 类。​

4

【强制】不允许在程序的任何地方使用：

1）java.sql.Date；

2）java.sql.Time；

3）java.sql.Timestamp。

​说明：第1 个不记录时间，getHours()抛出异常；第2 个不记录日期，getYear()抛出异常；第3 个在构造方法super((time/1000)*1000)时，在Timestamp 属性fastTime 和nanos 中分别存储秒和纳秒信息。​

反例：在使用java.util.Date.after(Date)进行时间比较时，当入参是java.sql.Timestamp 时，会触发JDK BUG(JDK 9 已修复)，在比较时可能导致意外结果。

5

【强制】不要在程序中写死一年为365 天，避免在闰年时出现日期转换错误或程序逻辑错误。

正例：

// 获取今年的天数

int days = LocalDate.now().lengthOfYear();

// 获取指定某年的天数

LocalDate.of(2011, 1, 1).lengthOfYear();

反例：

// 第一种情况：在闰年（366 天）时，出现数组越界异常

int[] dayArray = new int[365];

// 第二种情况：一年有效期的会员制，今年1 月26 日注册，硬编码

// 一年为365 天，返回的却是1 月25 日

Calendar calendar = Calendar.getInstance();

calendar.set(2020, 0, 26);

calendar.add(Calendar.DATE, 365);

6

【推荐】避免出现闰年2 月问题。闰年的2 月有29 天，一年后的那一天不可能是2 月29 日。

7

【推荐】使用枚举值指代月份。如果使用数字，则注意Date、Calendar 等日期相关类的月份（month）取值在0~11 之间。

​说明：参考JDK 原生注释，Month value is 0-based.​

​e.g. 0 for January.​

正例：用 Calendar.JANUARY、Calendar.FEBRUARY、Calendar.MARCH 等指代相应月份，进行传参或比较。