JDK1.8 中的日期与时间 API

不念不忘少年蓝@ 2023-01-11 13:00 186阅读 0赞

**为什么 JDK 1.8 之前的时间与日期 API 不好用？**

1、java.util.Date 是从 JDK 1.0 开始提供，易用性差

*  默认是中欧时区(Central Europe Time)
 *  起始年份是 1900 年
 *  起始月份从 0 开始
 *  对象创建之后可修改

2、JDK 1.1 废弃了 Date 中很多方法，新增了并建议使用 java.util.Calendar 类

*  相比 Date 去掉了年份从 1900 年开始
 *  月份依然从 0 开始
 *  选用 Date 或 Calendar，让人更困扰

3、DateFormat 格式化时间，线程不安全

为了解决 JDK 中时间与日期较难使用的问题，JDK 1.8 开始，吸收了 Joda-Time 很多功能，新增 java.time 包，加了**新特性**：

*  区分适合人阅读的和适合机器计算的时间与日期类
 *  日期、时间及对比相关的对象创建完均不可修改
 *  可并发解析与格式化日期与时间
 *  支持设置不同的时区与历法

<table> 
 <tbody> 
  <tr> 
   <td>LocalDate</td> 
   <td>本地日期</td> 
  </tr> 
  <tr> 
   <td>LocalTime</td> 
   <td>本地时间</td> 
  </tr> 
  <tr> 
   <td>LocalDateTime</td> 
   <td>本地日期+时间</td> 
  </tr> 
  <tr> 
   <td>Instant</td> 
   <td>时间戳，适合机器时间计算</td> 
  </tr> 
  <tr> 
   <td>Duration</td> 
   <td>时间差</td> 
  </tr> 
  <tr> 
   <td>Period</td> 
   <td>年、月、日差</td> 
  </tr> 
  <tr> 
   <td>ZoneOffset</td> 
   <td>时区偏移量</td> 
  </tr> 
  <tr> 
   <td>ZonedDateTime</td> 
   <td>带时区的日期时间</td> 
  </tr> 
  <tr> 
   <td>Clock</td> 
   <td>时钟，获取其他地区时钟</td> 
  </tr> 
  <tr> 
   <td>DateTimeFormatter</td> 
   <td>时间格式化</td> 
  </tr> 
  <tr> 
   <td colspan="1">Temporal</td> 
   <td colspan="1">日期-时间获取值的字段</td> 
  </tr> 
  <tr> 
   <td colspan="1">TemporalAdjuster</td> 
   <td colspan="1">emporal 对象转换，实现自定义</td> 
  </tr> 
  <tr> 
   <td>ChronoLocalDate</td> 
   <td>日历系统接口</td> 
  </tr> 
 </tbody> 
</table>

**常用 api**

1、 获取当前日期

LocalDate.now()

2、创建日期

LocalDate date = LocalDate.of(2020, 9, 21)

3、获取年份

date.getYear()
    
    //通过 TemporalField 接口的实现枚举类 ChronoField.YEAR 获取年份
    date.get(ChronoField.YEAR)

4、获取月份

date.getMonth().getValue()
    
    //通过 TemporalField 接口的实现枚举类 ChronoField.MONTH_OF_YEAR 获取月份
    date.get(ChronoField.MONTH_OF_YEAR)

5、获取日

date.getDayOfMonth()
    
    //通过 TemporalField 接口的实现枚举类 ChronoField.DAY_OF_MONTH 获取日
    date.get(ChronoField.DAY_OF_MONTH)

6、获取周几

date.getDayOfWeek()

7、获取当前月多少天

date.lengthOfMonth()

8、获取当前年是否为闰年

date.isLeapYear()

9、当前时间

LocalTime nowTime = LocalTime.now()

10、创建时间

LocalTime.of(23, 59, 59)

11、获取时

nowTime.getHour()

12、获取分

nowTime.getMinute()

13、获取秒

nowTime.getSecond()

14、获取毫秒

nowTime.getLong(ChronoField.MILLI_OF_SECOND)

15、获取纳秒

nowTime.getNano()

16、创建日期时间对象

LocalDateTime.of(2020, 9, 21, 1, 2, 3);
    LocalDateTime.of(date, nowTime);

17、获取当前日期时间对象

LocalDateTime.now()

18、通过 LocalDate 创建日期时间对象

date.atTime(1, 2, 3)

19、通过 LocalTime 创建日期时间对象

nowTime.atDate(date)

20、通过 LocalDateTime 获取 LocalDate 对象

LocalDateTime.now().toLocalDate()

21、通过 LocalDateTime 获取 LocalTime 对象

LocalDateTime.now().toLocalTime()

22、解析日期字符串

LocalDate.parse("2020-09-21")

23、解析时间字符串

LocalTime.parse("01:02:03")

24、解析日期时间字符串

LocalDateTime.parse("2020-09-21T01:02:03", DateTimeFormatter.ISO_LOCAL_DATE_TIME)

25、方便时间建模、机器处理的时间处理类 Instant，起始时间 1970-01-01 00:00:00

//起始时间 + 3 秒
    Instant.ofEpochSecond(3)
    //起始时间 + 3 秒 + 100 万纳秒
    Instant.ofEpochSecond(3, 1_000_000_000)
    //起始时间 + 3 秒 - 100 万纳秒
    Instant.ofEpochSecond(3, -1_000_000_000))
    //距离 1970-01-01 00:00:00 毫秒数
    Instant.now().toEpochMilli()

26、Duration：LocalTime、LocalDateTime、Intant 的时间差处理

Duration.between(LocalTime.parse("01:02:03"), LocalTime.parse("02:03:04"))
    Duration.between(LocalDateTime.parse("2020-09-21T01:02:03"), LocalDateTime.parse("2020-09-22T02:03:04"))
    Duration.between(Instant.ofEpochMilli(1600623455080L), Instant.now())

27、日期时间，前、后、相等比较

//2020-09-21 在 2020-09-18 前？
    LocalDate.parse("2020-09-21").isBefore(LocalDate.parse("2020-09-18"))
    //01:02:03 在 02:03:04 后？
    LocalTime.parse("01:02:03").isAfter(LocalTime.parse("02:03:04"))

28、修改日期、时间对象，返回副本

//修改日期返回副本
    LocalDate.now().withYear(2019).withMonth(9).withDayOfMonth(9)
    LocalDate date4Cal = LocalDate.now();
    //加一周
    date4Cal.plusWeeks(1)
    //减两个月
    date4Cal.minusMonths(2)
    //减三年
    date4Cal.minusYears(3)

29、格式化

//格式化当前日期
    LocalDate.now().format(DateTimeFormatter.ISO_LOCAL_DATE)
    //指定格式，格式化当前日期
    LocalDate.now().format(DateTimeFormatter.ofPattern("yyyyMMdd"))
    指定格式，格式化当前日期时间
    //格式化当前日期时间
    LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMdd  HH:mm:ss"))

30、解析

//日期解析
    LocalDate.parse("2020-09-20")
    //指定格式，日期解析
    LocalDate.parse("2020/09/20", DateTimeFormatter.ofPattern("yyyy/MM/dd"))
    //指定格式，日期时间解析
    LocalDateTime.parse("2020/09/20 01:01:03", DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss"))

31、时区

//上海时区
    ZoneId shanghaiZone = ZoneId.of("Asia/Shanghai");
    //设置日期为上海时区
    LocalDate.now().atStartOfDay(shanghaiZone)
    //设置日期时间为上海时区
    LocalDateTime.now().atZone(shanghaiZone)
    //设置 Instant 为上海时区
    Instant.now().atZone(shanghaiZone)

32、子午线时间差

//时间差减 1 小时
    ZoneOffset offset = ZoneOffset.of("-01:00");
    //设置时间差
    OffsetDateTime.of(LocalDateTime.now(), offset)

--------------------

### 【Java学习资源】整理推荐 ###

*  [Java 8 Stream Api demo][]
 *  [Druid 使用][Druid]
 *  [借助 libreoffice，word 转 pdf 体验][libreoffice_word _ pdf]
 *  [Java 动态代理][Java]
 *  [openjdk jol 工具打印 Java 对象内存布局][openjdk jol _ Java]
 *  [Spring整合MyBatis][Spring_MyBatis]
 *  [MyBatis 自定义插件][MyBatis]
 *  [MyBatis 延迟加载][MyBatis 1]
 *  [MyBatis 1对1 1对多 关联查询][MyBatis 1_1 1_]
 *  [MyBatis insert 获取自增主键][MyBatis insert]
 *  [MyBatis 批量插入][MyBatis 2]
 *  [分页插件 Mybatis-PageHelper][Mybatis-PageHelper]
 *  [MyBatis 原生使用][MyBatis 3]
 *  [Sharding-JDBC 实现分库分表][Sharding-JDBC]
 *  [JDK1.8 中的日期与时间 API][JDK1.8 _ API]
 *  [Sharding-JDBC 实现读写分离][Sharding-JDBC 1]

--------------------

### 【Java面试题与答案】整理推荐 ###

*  [基础与语法][Link 1]
 *  [集合][Link 2]
 *  [网络编程][Link 3]
 *  [并发编程][Link 4]
 *  [Web][]
 *  [安全][Link 5]
 *  [设计模式][Link 6]
 *  [框架][Link 7]
 *  [算法与数据结构][Link 8]
 *  [异常][Link 9]
 *  [文件解析与生成][Link 10]
 *  [Linux][]
 *  [MySQL][]
 *  [Oracle][]
 *  [Redis][]
 *  [Dubbo][]

[Java 8 Stream Api demo]: https://www.javanav.com/val/5be3f821d00e4cc5b6177c9d0e5dd30f.html
[Druid]: https://www.javanav.com/val/79860880b84442cfb0f6f5e094d53105.html
[libreoffice_word _ pdf]: https://www.javanav.com/val/501ababe5c48493780ed23dbbc7b2cbc.html
[Java]: https://www.javanav.com/val/ab11038d7de64b4b8c0e384d1d4a9ab0.html
[openjdk jol _ Java]: https://www.javanav.com/val/66e564087e244b2f99f85091de029605.html
[Spring_MyBatis]: https://www.javanav.com/val/687c224b31a34d3c9f99fee67e3d5bcc.html
[MyBatis]: https://www.javanav.com/val/a5535343f9b545eda9665f03d62345ba.html
[MyBatis 1]: https://www.javanav.com/val/973ded541e9244aa8b3169b9fb869d60.html
[MyBatis 1_1 1_]: https://www.javanav.com/val/a9fe4555c1614b40b0da07afeabf2a66.html
[MyBatis insert]: https://www.javanav.com/val/3ac331d2674b4c108469cce54ae126f3.html
[MyBatis 2]: https://www.javanav.com/val/2d21b1463f2e4faeaf0def0c49df34a4.html
[Mybatis-PageHelper]: https://www.javanav.com/val/a8a8009f878d47dc9167bf20b9e0ab57.html
[MyBatis 3]: https://www.javanav.com/val/07f60d7946204b3b893abd5dc8bd2fa3.html
[Sharding-JDBC]: https://www.javanav.com/val/eefddd846ae845668daf9d798755c057.html
[JDK1.8 _ API]: https://www.javanav.com/val/fefecf2f089e48b294708e99954c57a1.html
[Sharding-JDBC 1]: https://www.javanav.com/val/f05fe12cb8fd444aaa59fb7f747a3224.html
[Link 1]: https://www.javanav.com/interview/93b0069472fd479393006c0e73043fc4.html
[Link 2]: https://www.javanav.com/interview/4147d95e693945e7a50345fd33ec817e.html
[Link 3]: https://www.javanav.com/interview/68a57ffc78de4133bb890bdd502ac418.html
[Link 4]: https://www.javanav.com/interview/36a24fa3258e45c89873f474ce914912.html
[Web]: https://www.javanav.com/interview/4e27cb63adb440c6825a159d35cf4010.html
[Link 5]: https://www.javanav.com/interview/03affb2ce3f04fda8853f714e5764906.html
[Link 6]: https://www.javanav.com/interview/07a32a9ff17a4006a53550ce658cafed.html
[Link 7]: https://www.javanav.com/interview/5c466456e9b54ab0a749b5948e51f1d3.html
[Link 8]: https://www.javanav.com/interview/943f917041ee4f05add24539f5b861b2.html
[Link 9]: https://www.javanav.com/interview/d3f058cfc05d4c6dadd821b622e84d36.html
[Link 10]: https://www.javanav.com/interview/67a50996c28f418e83b109ea42fc3eff.html
[Linux]: https://www.javanav.com/interview/00cccb81729540d1923bd0a0ef49533a.html
[MySQL]: https://www.javanav.com/interview/d311e78502a845f1a4bb307bd6aec2b3.html
[Oracle]: https://www.javanav.com/interview/5f29e9677edf4a16be3dce30d257c9ab.html
[Redis]: https://www.javanav.com/interview/066c62b3af4d4827b2243a822c3084a9.html
[Dubbo]: https://www.javanav.com/interview/9a3e7a7740324757abaab953f7ebc455.html