1.【强制】日期格式化时,传入pattern中表示年份统一使用小写的y。
说明:日期格式化时,yyyy表示当天所在的年,而大写的YYYY代表是week in which year(JDK7之后引入的概念),意思是当天所在的周属于的年份,一周从周日开始,周六结束,只要本周跨年,返回的YYYY就是下一年。
正例:表示日期和时间的格式如下所示:
new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
反例:某业务因使用YYYY/MM/dd进行日期格式化,2017/12/31执行结果为2018/12/31,导致在2017年12月31日当日实时消耗跌0,造成P2故障。
2.【强制】在日期格式中分清楚大写的M和小写的m,大写的H和小写的h分别指代的意义。
说明:日期格式中的这两对字母表意如下:
- 表示月份是大写的M;
- 表示分钟则是小写的m;
- 24小时制的是大写的H;
- 12小时制的则是小写的h。
3.【强制】获取当前毫秒数:System.currentTimeMillis()
; 而不是new Date().getTime()
;
说明:如果想获取更加精确的纳秒级时间值,使用System.nanoTime
的方式。在JDK8中,针对统计时间等场景,推荐使用Instant
类。
为什么不让使用new Date().getTime()
:
因为Date的源码中也是调用的System.currentTimeMillis()方法,所以直接使用System.currentTimeMillis()会比new一个Date对象性能高。
public Date() {
this(System.currentTimeMillis());
}
4.【强制】不允许在程序中使用java.sql.Date和java.sql.Time。
说明:前者不记录时间,getHours()抛出异常。后者不记录日期,getYear()抛出异常。
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.【推荐】避免闰年二月问题。闰年的二月份有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
等来指代相应月份来进行传参或比较。