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



相关文章
|
2月前
|
Java
Java开发实现图片URL地址检验,如何编码?
【10月更文挑战第14天】Java开发实现图片URL地址检验,如何编码?
79 4
|
15天前
|
Java API Maven
如何使用Java开发抖音API接口?
在数字化时代,社交媒体平台如抖音成为生活的重要部分。本文详细介绍了如何用Java开发抖音API接口,从创建开发者账号、申请API权限、准备开发环境,到编写代码、测试运行及注意事项,全面覆盖了整个开发流程。
58 10
|
2月前
|
监控 Java 测试技术
Java开发现在比较缺少什么工具?
【10月更文挑战第15天】Java开发现在比较缺少什么工具?
36 1
|
2月前
|
Java
Java开发实现图片地址检验,如果无法找到资源则使用默认图片,如何编码?
【10月更文挑战第14天】Java开发实现图片地址检验,如果无法找到资源则使用默认图片,如何编码?
62 2
|
22天前
|
SQL 安全 Java
安全问题已经成为软件开发中不可忽视的重要议题。对于使用Java语言开发的应用程序来说,安全性更是至关重要
在当今网络环境下,Java应用的安全性至关重要。本文深入探讨了Java安全编程的最佳实践,包括代码审查、输入验证、输出编码、访问控制和加密技术等,帮助开发者构建安全可靠的应用。通过掌握相关技术和工具,开发者可以有效防范安全威胁,确保应用的安全性。
44 4
|
23天前
|
缓存 监控 Java
如何运用JAVA开发API接口?
本文详细介绍了如何使用Java开发API接口,涵盖创建、实现、测试和部署接口的关键步骤。同时,讨论了接口的安全性设计和设计原则,帮助开发者构建高效、安全、易于维护的API接口。
57 4
|
1月前
|
开发框架 JavaScript 前端开发
HarmonyOS UI开发:掌握ArkUI(包括Java UI和JS UI)进行界面开发
【10月更文挑战第22天】随着科技发展,操作系统呈现多元化趋势。华为推出的HarmonyOS以其全场景、多设备特性备受关注。本文介绍HarmonyOS的UI开发框架ArkUI,探讨Java UI和JS UI两种开发方式。Java UI适合复杂界面开发,性能较高;JS UI适合快速开发简单界面,跨平台性好。掌握ArkUI可高效打造符合用户需求的界面。
91 8
|
29天前
|
SQL Java 程序员
倍增 Java 程序员的开发效率
应用计算困境:Java 作为主流开发语言,在数据处理方面存在复杂度高的问题,而 SQL 虽然简洁但受限于数据库架构。SPL(Structured Process Language)是一种纯 Java 开发的数据处理语言,结合了 Java 的架构灵活性和 SQL 的简洁性。SPL 提供简洁的语法、完善的计算能力、高效的 IDE、大数据支持、与 Java 应用无缝集成以及开放性和热切换特性,能够大幅提升开发效率和性能。
|
29天前
|
存储 Java 关系型数据库
在Java开发中,数据库连接是应用与数据交互的关键环节。本文通过案例分析,深入探讨Java连接池的原理与最佳实践
在Java开发中,数据库连接是应用与数据交互的关键环节。本文通过案例分析,深入探讨Java连接池的原理与最佳实践,包括连接创建、分配、复用和释放等操作,并通过电商应用实例展示了如何选择合适的连接池库(如HikariCP)和配置参数,实现高效、稳定的数据库连接管理。
52 2
|
29天前
|
监控 Java 数据库连接
在Java开发中,数据库连接管理是关键问题之一
在Java开发中,数据库连接管理是关键问题之一。本文介绍了连接池技术如何通过预创建和管理数据库连接,提高数据库操作的性能和稳定性,减少资源消耗,并简化连接管理。通过示例代码展示了HikariCP连接池的实际应用。
20 1