阿里巴巴Java开发手册(第2版)-第1章(5)

简介: 本章是传统意义上的代码规范,包括变量命名、代码风格、控制语句、代码注释、前后端规约等基本的编程习惯,以及从高并发场景中提炼出来的集合处理技巧与并发多线程的注意事项。

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 等指代相应月份,进行传参或比较。



相关文章
|
5天前
|
存储 Java 数据库连接
使用Java开发桌面应用程序
使用Java开发桌面应用程序
14 0
|
5天前
|
Java API 开发工具
java与Android开发入门指南
java与Android开发入门指南
12 0
|
5天前
|
分布式计算 负载均衡 Java
构建高可用性Java应用:介绍分布式系统设计与开发
构建高可用性Java应用:介绍分布式系统设计与开发
9 0
|
5天前
|
前端开发 安全 Java
使用Spring框架加速Java开发
使用Spring框架加速Java开发
43 0
|
5天前
|
前端开发 JavaScript Java
Java与Web开发的结合:JSP与Servlet
Java与Web开发的结合:JSP与Servlet
10 0
|
5天前
|
设计模式 算法 Java
设计模式在Java开发中的应用
设计模式在Java开发中的应用
16 0
|
5天前
|
监控 Java Maven
揭秘Java Agent技术:解锁Java工具开发的新境界
作为JDK提供的关键机制,Java Agent技术不仅为Java工具的开发者提供了一个强大的框架,还为性能监控、故障诊断和动态代码修改等领域带来了革命性的变革。本文旨在全面解析Java Agent技术的应用场景以及实现方式,特别是静态加载模式和动态加载模式这两种关键模式。
28 0
|
6天前
|
存储 Java 开发者
探索Java开发中触发空指针异常的场景
作为一名后端开发者在Java编程的世界中,想必大家对空指针并不陌生,空指针异常是一种常见而又令人头疼的问题,它可能会在我们最不经意的时候突然出现,给我们的代码带来困扰,甚至导致系统的不稳定性,而且最可怕的是有时候不能及时定位到它的具体位置。针对这个问题,我们需要深入了解触发空指针异常的代码场景,并寻找有效的方法来识别和处理这些异常情况,而且我觉得空指针异常是每个Java开发者都可能面临的挑战,但只要我们深入了解它的触发场景,并采取适当的预防和处理措施,我们就能够更好地应对这个问题。那么本文就来分享一下实际开发中一些常见的触发空指针异常的代码场景,并分享如何有效地识别和处理这些异常情况。
20 1
探索Java开发中触发空指针异常的场景
|
7天前
|
传感器 人工智能 前端开发
JAVA语言VUE2+Spring boot+MySQL开发的智慧校园系统源码(电子班牌可人脸识别)Saas 模式
智慧校园电子班牌,坐落于班级的门口,适合于各类型学校的场景应用,班级学校日常内容更新可由班级自行管理,也可由学校统一管理。让我们一起看看,电子班牌有哪些功能呢?
70 4
JAVA语言VUE2+Spring boot+MySQL开发的智慧校园系统源码(电子班牌可人脸识别)Saas 模式
|
14天前
|
Java 索引
Java String应用与开发
Java String应用与开发
22 0