Java开发规范学习--日期和时间

近期，阿里巴巴发布了《Java开发手册（泰山版）》。

摘录部分官网的说明

《Java开发手册》始于阿里内部规约，在全球Java开发者共同努力下，已成为业界普遍遵循的开发规范。
手册涵盖编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程规约、设计规约七大维度。
此次泰山版发布，将带来三大亮点：新增5条日期时间规约；新增2条表别名sql规约；新增统一错误码规约。

阿里在2016年12月7日首次向业界开放《Java开发手册》以来，获得了绝大部分开发者的认可，目前已经成为行业的事实标准。很多公司直接引用作为内部的编码规范标准，或者在此基础上再针对自己行业的情况来扩展一些内部规约来形成自己的编码规范标准。在开发手册的指导下，限制了过度的个性化，以一个相对统一的标准，提升了代码的可读性，降低了沟通成本。

现在一些公司在面试Java开发的时候，会要求看候选人的github上的代码，来考察候选人在编码规范、风格方面是否能符合业界统一的规范，因为规范的代码会给团队带来很多好处，逻辑清晰，阅读友好，别人接手起来也易于维护和升级。所以，作为开发者来说，学习最新版《Java开发手册》，不仅是对自身编码能力的提升，对团队协作、适用这个不断变化的开发生态也很重要。

因为之前学习过之前的版本，所以本次主要针对新增的内容进行一下学习，也说说自己的理解，今天先来说的是，日期和时间相关的内容。

先来看一下《Java开发手册（泰山版）》关于这块的内容

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

说明：日期格式化时，yyyy 表示当天所在的年，而大写的 YYYY 代表是 week in which year（JDK7 之后引入的概念），意思是当天所在的周属于的年份，一周从周日开始，周六结束，只要本周跨年，返回的 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 的方式。在 JDK8 中，针对统计时间等场景，推荐使用 Instant 类。

4. 【强制】不允许在程序任何地方中使用：1）java.sql.Date 2）java.sql.Time 3）java.sql.Timestamp。

说明：第 1 个不记录时间，getHours()抛出异常；第 2 个不记录日期，getYear()抛出异常；第 3 个在构造方法 super((time/1000)*1000)，fastTime 和 nanos 分开存储秒和纳秒信息。
反例： java.util.Date.after(Date)进行时间比较时，当入参是 java.sql.Timestamp 时，会触发 JDK BUG(JDK9 已修复)，可能导致比较时的意外结果。

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

正例࿱