Java中有哪些可以用于日期和时间的API?

心已赠人 2024-03-23 19:46 68阅读 0赞

从Java 8开始，java.time包提供了新的日期和时间API，新增的API严格区分了时刻、本地日期、本地时间，并且，对日期和时间进行运算更加方便。主要涉及的类型有以下几类：

LocalDate：不包含具体时间的日期。

LocalTime：不含日期的时间。

LocalDateTime：包含了日期及时间。

Instant：代表的是时间戳。

DateTimeFormatter 用于做时间的格式化和解析的

Duration:用于计算两个“时间”间隔

Period:用于计算两个“日期”间隔

新API的类型几乎全部是不变类型(和String的使用类似)，可以放心使用不必担心被修改。其中LocalDate、LocalTime、LocalDateTime，分别表示日期，时间，日期时间对象，他们的类的实例是不可变的对象。他们三者构建对象和API都是通用的。

构建对象的方式如下：

![构建对象][00e0bdcf852c8e086a32ea5157043e46.png]

LocalDate、LocalTime、LocalDateTime获取信息的API。

![LocalDateTime获取信息的API][LocalDateTime_API]

修改相关的API

LocalDateTime 综合了 LocalDate 和 LocalTime 里面的方法，所以下面只用 LocalDate 和 LocalTime 来举例。这些方法返回的是一个新的实例引用，因为LocalDateTime 、LocalDate 、LocalTime 都是不可变的。

![修改api][api]

**Instant时间戳**

JDK8获取时间戳特别简单，且功能更丰富。Instant类由一个静态的工厂方法now()可以返回当前时间戳。

Instant instant = Instant.now();
    System.out.println("当前时间戳是：" + instant);
    
    Date date = Date.from(instant);
    System.out.println("当前时间戳是：" + date);
    
    instant = date.toInstant();
    System.out.println(instant);

时间戳是包含日期和时间的，与java.util.Date很类似，事实上Instant就是类似JDK8 以前的Date。Instant和Date这两个类可以进行转换。

**DateTimeFormatter**

在JDK8中，引入了一个全新的日期与时间格式器DateTimeFormatter。正反都能调用format方法。

LocalDateTime ldt = LocalDateTime.now();
    System.out.println(ldt);//2021-03-01T15:09:17.444190900
    
    DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
    String ldtStr = ldt.format(dtf);
    System.out.println(ldtStr);//2021-03-01 15:09:17
    
    String ldtStr1 = dtf.format(ldt);
    System.out.println(ldtStr1);//2021-03-01 15:09:17

**Period**

在Java8中，我们可以使用以下类来计算日期间隔差异：java.time.Period。主要是 Period 类方法 getYears()，getMonths() 和 getDays() 来计算,只能精确到年月日。用于 LocalDate 之间的比较。

LocalDate today = LocalDate.now();
    System.out.println(today);     // 2021-03-01
    LocalDate birthDate = LocalDate.of(1995, 1, 11);
    System.out.println(birthDate); // 1995-01-11
    Period period = Period.between(birthDate, today);
    System.out.printf("年龄 : %d 年 %d 月 %d 日", period.getYears(), period.getMonths(),
     period.getDays());

**Duration**

在Java8中，我们可以使用以下类来计算时间间隔差异：java.time.Duration，基于时间的值，测量时间量的方法。用于 LocalDateTime 之间的比较。也可用于 Instant 之间的比较。

LocalDateTime today = LocalDateTime.now();
    System.out.println(today);
    LocalDateTime birthDate = LocalDateTime.of(1990,10,1,10,50,30);
    System.out.println(birthDate);
    
    Duration duration = Duration.between(birthDate, today);//第二个参数减第一个参数
    System.out.println(duration.toDays());//两个时间差的天数
    System.out.println(duration.toHours());//两个时间差的小时数
    System.out.println(duration.toMinutes());//两个时间差的分钟数
    System.out.println(duration.toMillis());//两个时间差的毫秒数
    System.out.println(duration.toNanos());//两个时间差的纳秒数

Duration用于计算两个“时间”间隔。 Period用于计算两个“日期”间隔。

**Java.time.temporal.ChronoUnit**

ChronoUnit类可用于在单个时间单位内测量一段时间，这个工具类是最全的了，可以用于比较所有的时间单位。

LocalDateTime today = LocalDateTime.now(); 
    System.out.println(today); 
    LocalDateTime birthDate = LocalDateTime.of(1990,10,1,10,50,30); 
    System.out.println(birthDate); 
    
    System.out.println("相差的年数：" + ChronoUnit.YEARS.between(birthDate, today)); 
    System.out.println("相差的月数：" + ChronoUnit.MONTHS.between(birthDate, today)); 
    System.out.println("相差的周数：" + ChronoUnit.WEEKS.between(birthDate, today)); 
    System.out.println("相差的天数：" + ChronoUnit.DAYS.between(birthDate, today)); 
    System.out.println("相差的时数：" + ChronoUnit.HOURS.between(birthDate, today)); 
    System.out.println("相差的分数：" + ChronoUnit.MINUTES.between(birthDate, today)); 
    System.out.println("相差的秒数：" + ChronoUnit.SECONDS.between(birthDate, today)); 
    System.out.println("相差的毫秒数：" + ChronoUnit.MILLIS.between(birthDate, today)); 
    System.out.println("相差的微秒数：" + ChronoUnit.MICROS.between(birthDate, today)); 
    System.out.println("相差的纳秒数：" + ChronoUnit.NANOS.between(birthDate, today)); 
    
    System.out.println("相差的半天数：" + ChronoUnit.HALF_DAYS.between(birthDate, today)); 
    System.out.println("相差的十年数：" + ChronoUnit.DECADES.between(birthDate, today)); 
    System.out.println("相差的世纪(百年)数：" + ChronoUnit.CENTURIES.between(birthDate, today)); 
    System.out.println("相差的千年数：" + ChronoUnit.MILLENNIA.between(birthDate, today)); 
    System.out.println("相差的纪元数：" + ChronoUnit.ERAS.between(birthDate, today));

[00e0bdcf852c8e086a32ea5157043e46.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/fd731aff4d0b42e59a93e53cc8d8756d.png
[LocalDateTime_API]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/69014b7c89a8486c9bddad9b8ae081d5.png
[api]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/df5707aa761a420090e2b76411b25b2b.png