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



相关文章
|
人工智能 前端开发 Java
2025年WebStorm高效Java开发全指南:从配置到实战
WebStorm 2025不仅是一款强大的JavaScript IDE,也全面支持Java开发。本文详解其AI辅助编程、Java特性增强及性能优化,并提供环境配置、高效开发技巧与实战案例,助你打造流畅的全栈开发体验。
978 4
|
前端开发 JavaScript Java
Java 开发中 Swing 界面嵌入浏览器实现方法详解
摘要:Java中嵌入浏览器可通过多种技术实现:1) JCEF框架利用Chromium内核,适合复杂网页;2) JEditorPane组件支持简单HTML显示,但功能有限;3) DJNativeSwing-SWT可内嵌浏览器,需特定内核支持;4) JavaFX WebView结合Swing可完美支持现代网页技术。每种方案各有特点,开发者需根据项目需求选择合适方法,如JCEF适合高性能要求,JEditorPane适合简单展示。(149字)
1470 1
|
10月前
|
安全 前端开发 Java
《深入理解Spring》:现代Java开发的核心框架
Spring自2003年诞生以来,已成为Java企业级开发的基石,凭借IoC、AOP、声明式编程等核心特性,极大简化了开发复杂度。本系列将深入解析Spring框架核心原理及Spring Boot、Cloud、Security等生态组件,助力开发者构建高效、可扩展的应用体系。(238字)
|
安全 Java 领域建模
Java 17 探秘:不容错过的现代开发利器
Java 17 探秘:不容错过的现代开发利器
1292 0
|
11月前
|
消息中间件 人工智能 Java
抖音微信爆款小游戏大全:免费休闲/竞技/益智/PHP+Java全筏开源开发
本文基于2025年最新行业数据,深入解析抖音/微信爆款小游戏的开发逻辑,重点讲解PHP+Java双引擎架构实战,涵盖技术选型、架构设计、性能优化与开源生态,提供完整开源工具链,助力开发者从理论到落地打造高留存、高并发的小游戏产品。
|
JavaScript 安全 前端开发
Java开发:最新技术驱动的病人挂号系统实操指南与全流程操作技巧汇总
本文介绍基于Spring Boot 3.x、Vue 3等最新技术构建现代化病人挂号系统,涵盖技术选型、核心功能实现与部署方案,助力开发者快速搭建高效、安全的医疗挂号平台。
504 3
|
安全 Java 数据库
Java 项目实战病人挂号系统网站设计开发步骤及核心功能实现指南
本文介绍了基于Java的病人挂号系统网站的技术方案与应用实例,涵盖SSM与Spring Boot框架选型、数据库设计、功能模块划分及安全机制实现。系统支持患者在线注册、登录、挂号与预约,管理员可进行医院信息与排班管理。通过实际案例展示系统开发流程与核心代码实现,为Java Web医疗项目开发提供参考。
521 2
|
11月前
|
存储 Java 关系型数据库
Java 项目实战基于面向对象思想的汽车租赁系统开发实例 汽车租赁系统 Java 面向对象项目实战
本文介绍基于Java面向对象编程的汽车租赁系统技术方案与应用实例,涵盖系统功能需求分析、类设计、数据库设计及具体代码实现,帮助开发者掌握Java在实际项目中的应用。
412 0