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 时,会触发JDKBUG(JDK9 已修复),可能导致比较时的意外结果。

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

    正例:

// 获取今年的天数
int daysOfThisYear = 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, 1, 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等来指代相应月份来进行传参或比较。

本文参考于《java开发手册》

版权声明:参考文章后编写,版权归站长和原作者所有,转载请标明出处
转载请注明:https://blog.grstudy.com/programming/note/71
免责声明&联系方式
作者头像
boss创始人

一位简简单单的系统研发员

上一篇: java开发手册-编程规约-OOP规约
下一篇: java开发手册-编程规约-集合处理