Initial commit

doc/开发标准/时间.md

@@ -0,0 +1,70 @@
+JDK与时间相关的包和API:
+
+# 包
+
+包      | 引入   | 描述 
+-------|------|-------------
+java.time | 1.8+ | 推荐使用
+java.util | 旧版   | 不推荐
+java.text | 旧版   | 日期字符串格式化相关，不推荐使用
+java.sql  | 1.1  | 数据库相关，业务不推荐使用
+java.time.chrono| 1.8 | 可选，能不用就不用。支持非 ISO 历法系统
+
+# java.time包中的类
+| 类/接口                | 用途                    |
+| ------------------- | --------------------- |
+| `LocalDate`         | 日期（年-月-日）             |
+| `LocalTime`         | 时间（时:分:秒.纳秒）          |
+| `LocalDateTime`     | 日期+时间                 |
+| `ZonedDateTime`     | 带时区的日期时间              |
+| `Instant`           | 时间戳（从1970-01-01的秒/毫秒） |
+| `Duration`          | 时间间隔（基于秒和纳秒）          |
+| `Period`            | 日期间隔（基于年月日）           |
+| `DateTimeFormatter` | 日期时间格式化               |
+LocalDate,LocalTime，LocalDateTime都是指表示一个时间数字，没有时区概念。比如LocalTime表示8:20，并不能表示出具体的时间，需要结合时区才能知道是哪里的8:20。
+
+
+java.time.format
+DateTimeFormatter 及其相关类
+用于格式化与解析日期时间
+java.time.temporal
+   时间访问和调整的底层接口
+   包含 Temporal, TemporalField, TemporalUnit 等 
+
+java.time.zone
+   时区相关类
+   ZoneId, ZoneOffset, ZoneRules 等
+
+# java.util包中的类
+| 类          | 说明                |
+| ---------- |-------------------|
+| `Date`     | 传统日期类（已不推荐），不带时区  |
+| `Calendar` | 日历计算（已不推荐），默认系统时区 |
+| `TimeZone` | 时区信息              |
+
+# java.text包中的类
+SimpleDateFormat - 旧版日期格式化（线程不安全）
+
+# java.sql
+这些也都没有时区概念，只表示时间值
+| 类           | 用途      |
+| ----------- | ------- |
+| `Date`      | SQL 日期  |
+| `Time`      | SQL 时间  |
+| `Timestamp` | SQL 时间戳 |
+
+# 最佳实践
+
+关于时区：
+1. 系统内部应该只用java.time下的LocalDate,LocalTime,LocalDateTime这些不带时区的概念。
+2. 只有与外部交互时，才应该转成带时区的概念。 比如把前端请求的日期转成LocalDateTime，返回给前端的时间应该转成前端对应时区的时间。或者请求外部依赖时，需要传递时间，应该确定好时区的概念。
+3. 定时任务的时间设置应该带上时区，否则将会按照系统所在时区执行，切换服务器时，时区会变，定时任务的执行时间也会变。
+作为中国开发者，应该都用东八区时间。`@Scheduled(cron = "2 15 0 * * ?", zone = "Asia/Shanghai")`
+4. 服务器的时区都设置成东八区时间
+
+查看时区:`timedatectl`
+列出可支持的时区:`timedatectl list-timezones | grep Shanghai`
+设置时区:`sudo timedatectl set-timezone Asia/Shanghai`
+
+关于存储时间的格式：
+1. 系统中只允许使用LocalDateTime，或者Long时间戳存储时间。优先用LocalDateTime，既拥有时间戳的所有信息，也有丰富的API操作时间。