【JAVA8新的时间与日期 API】- 本地时间、时间戳、日期时间的操纵、解析和格式化、时区、与传统日期的转换

时间 2020-07-02

标签 java8 java 新的时间日期 api 本地时间戳操纵解析格式化时区传统转换栏目 Java 繁體版

原文原文链接

LocalDate、 LocalTime、 LocalDateTime

LocalDate、 LocalTime、 LocalDateTime 类的实例是不可变对象，分表表示使用 ISO-8601 日历系统的日期、时间、日期和时间。他们提供了简单的日期或时间，并不包含当前的时间信息。也不包含与时区相关的信息。java

注：ISO-8601 日历系统是国际标准化组织制定的现代公民的日期和时间的表示法。说白了就是全球统一标准的表示方法。ui

示例1：

import org.junit.Test;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.Month;

public class TestLocalDateTime {
    @Test
    public void test1(){
        LocalDate localDate = LocalDate.now();
        System.out.println(localDate);//输出：2020-06-25
        LocalTime localTime = LocalTime.now();
        System.out.println(localTime);//输出：23:12:59.211
        LocalDateTime localDateTime = LocalDateTime.now();
        System.out.println(localDateTime);//输出：2020-06-25T23:12:59.211
        System.out.println("-------------------------------------------");
        localDate = LocalDate.of(2022,1,1);
        System.out.println(localDate);//输出：2022-01-01
        localDate = LocalDate.of(2023, Month.AUGUST,2);
        System.out.println("-------------------------------------------");
        System.out.println(localDate);//输出：2023-08-02
        localTime = LocalTime.of(1,2);
        System.out.println(localTime);//输出：01:02
        localTime = LocalTime.of(1,2,3);
        System.out.println(localTime);//输出：01:02:03
        localTime = LocalTime.of(1,2,3,4);
        System.out.println(localTime);//输出：01:02:03.000000004
        System.out.println("-------------------------------------------");
        localDateTime = LocalDateTime.of(localDate,localTime);
        System.out.println(localDateTime);//输出：2023-08-02T01:02:03.000000004
        localDateTime = LocalDateTime.of(2024,1,1,1,1);
        System.out.println(localDateTime);//输出：2024-01-01T01:01
        localDateTime = LocalDateTime.of(2024,1,1,1,1,1);
        System.out.println(localDateTime);//输出：2024-01-01T01:01:01
        localDateTime = LocalDateTime.of(2024,1,1,1,1,1,1);
        System.out.println(localDateTime);//输出：2024-01-01T01:01:01.000000001
        localDateTime = LocalDateTime.of(2024,Month.of(2),1,1,1,1,1);
        System.out.println(localDateTime);//输出：2024-02-01T01:01:01.000000001
    }
}

示例2：

 @Test
    public void test2(){
        LocalDate localDate = LocalDate.now();
        System.out.println(localDate);//输出：2020-06-30
        localDate = localDate.plusYears(1);
        System.out.println(localDate);//输出：2021-06-30
        localDate = localDate.plusMonths(2);
        System.out.println(localDate);//输出：2021-08-30
        localDate = localDate.plusDays(3);
        System.out.println(localDate);//输出：2021-09-02
        localDate = localDate.plusWeeks(4);
        System.out.println(localDate);//输出：2021-09-30
        localDate = localDate.plus(Period.ofDays(10));//加10天
        System.out.println(localDate);//输出：2021-10-10
        localDate = localDate.plus(Period.of(1,2,3));//加一年两个月三天
        System.out.println(localDate);//输出：2022-12-13
        localDate = localDate.plus(Period.ofYears(2));//加两年
        System.out.println(localDate);//输出：2024-12-13
        localDate = localDate.plus(1, ChronoUnit.DAYS);//加一天
        System.out.println(localDate);//输出：2024-12-14
        localDate = localDate.plus(1, ChronoUnit.MONTHS);//加一个月
        System.out.println(localDate);//输出：2025-01-14
        System.out.println("-------------------------------------------");
        localDate = localDate.minusYears(1);
        System.out.println(localDate);//输出：2024-01-14
        localDate.minusMonths(1);
        localDate.minusDays(1);
        localDate.minusWeeks(1);
        localDate.minus(Period.ofYears(2));
        //..........其余用法和plus同样...........
        System.out.println("-------------------------------------------");

        LocalTime localTime = LocalTime.now();
        System.out.println(localTime);//输出：21:35:54.776
        localTime = localTime.plusHours(1);
        System.out.println(localTime);//输出：22:35:54.776
        //..........其余用法和localDate的同样...........
        //..........LocalDateTime的用法也同样...........
    }

示例3：

    @Test
    public void test3(){
        LocalDate localDate = LocalDate.now();
        System.out.println(localDate);//输出：2020-06-30
        System.out.println(localDate.getYear());//输出：2020
        System.out.println(localDate.getDayOfMonth());//输出：30
        //..........等.......

        //将天数、月份、等修改成指定的值
        localDate = localDate.withDayOfMonth(22);
        System.out.println(localDate);//输出：2020-06-22
        localDate = localDate.withMonth(11);
        System.out.println(localDate);//输出：2020-11-22
        localDate = localDate.with(LocalDate.now());
        System.out.println(localDate);//输出：2020-06-30
        //..........等.......
        System.out.println("-------------------------------------------");

        Period period = localDate.until(LocalDate.of(2020, 1, 1));
        System.out.println(period.get(ChronoUnit.YEARS));//输出：0  相差 0 年
        System.out.println(period.get(ChronoUnit.MONTHS));//输出：-5  相差 1 - 6 = -5 月
        System.out.println(period.get(ChronoUnit.DAYS));//输出：-29  相差 1 - 30 = -29 天
        System.out.println("-------------------------------------------");

        System.out.println(localDate.isAfter(LocalDate.of(2020, 1, 1))); //输出：true
        System.out.println(localDate.isBefore(LocalDate.of(2020, 1, 1))); //输出：false
        System.out.println(localDate.isLeapYear());//是否闰年，输出：true
    }

Instant 时间戳

时间戳，以 Unix 元年：1970年1月1日00:00:00 到某个时间之间的毫秒值。spa

示例：

    @Test
    public void test4() {
        Instant ins1 = Instant.now();    // 默认获取UTC时区（世界协调时间，基本上是美国鬼子使用，和中国时间相差大概8小时）
        System.out.println(ins1);//输出结果：2020-06-30T14:28:05.217Z

        // 偏移量运算
        OffsetDateTime offsetDateTime = ins1.atOffset(ZoneOffset.ofHours(8));
        System.out.println(offsetDateTime);// 输出结果：2020-06-30T22:28:05.217+08:00    当前系统时间，国际标准的显示时间方式

        // 获取时间戳
        System.out.println(ins1.toEpochMilli());//输出结果：1593527285217

        // 以Unix元年为起点，进行偏移量运算
        Instant ins2 = Instant.ofEpochSecond(60);
        System.out.println(ins2);// 运行结果：1970-01-01T00:01:00Z
    }

Duration 和 Period 类

Duration ：计算两个 “时间” 之间的间隔。code

Period：计算两个“日期” 之间的间隔。orm

示例：

    @Test
    public void test5() throws Exception {
        Instant ins1 = Instant.now();
        Thread.sleep(1000);
        Instant ins2 = Instant.now();

        Duration duration = Duration.between(ins1, ins2);
        System.out.println(duration.toMillis()); // 运行结果：1000

        LocalTime localTime_1 = LocalTime.of(20,1,2);
        LocalTime localTime_2 = LocalTime.of(20,2,2);

        System.out.println(Duration.between(localTime_1, localTime_2).toMillis());// 运行结果：60000

        System.out.println("-------------------------------------------");

        LocalDate localDate_1 = LocalDate.of(2020,1, 1);
        LocalDate localDate_2 = LocalDate.now();

        Period period = Period.between(localDate_1, localDate_2);
        System.out.println(period.getYears());      // 运行结果：0
        System.out.println(period.getMonths());     // 运行结果：5
        System.out.println(period.getDays());       // 运行结果：29
    }

日期的操纵

TemporalAdjuster : 时间校订器。有时咱们可能须要获取例如：将日期调整到“下个周日”等操做。
TemporalAdjusters : 该类经过静态方法提供了大量的经常使用 TemporalAdjuster 的实现。对象

示例：

    @Test
    public void test6(){

        //TemporalAdjuster : 时间校订器。有时咱们可能须要获取例如：将日期调整到“下个周日”等操做。
        //TemporalAdjusters : 该类经过静态方法提供了大量的经常使用 TemporalAdjuster 的实现。
        LocalDate localDate = LocalDate.now();
        System.out.println(localDate);// 输出：2020-07-01
        localDate = localDate.with(TemporalAdjusters.lastDayOfMonth());
        System.out.println(localDate);// 输出：2020-07-31
        localDate = localDate.with(TemporalAdjusters.next(DayOfWeek.SUNDAY));
        System.out.println(localDate);// 输出：2020-08-02

        localDate = LocalDate.of(2020,7,3);//周五
        //自定义校订器：获取下一个工做日
        localDate = localDate.with(ld -> {
            LocalDate ld_ = (LocalDate) ld;
            DayOfWeek dayOfWeek =  ld_.getDayOfWeek();

            if (dayOfWeek.equals(DayOfWeek.FRIDAY)) {
                return ld_.plusDays(3);
            } else if (dayOfWeek.equals(DayOfWeek.SATURDAY)) {
                return ld_.plusDays(2);
            } else {
                return ld_.plusDays(1);
            }
        });
        System.out.println(localDate);// 输出：2020-07-06

    }

解析与格式化

java.time.format.DateTimeFormatter 类：该类提供了三种格式化方法：blog

预约义的标准格式
语言环境相关的格式
自定义的格式

示例：

    @Test
    public void test7(){
        // DateTimeFormatter 格式化 时间/日期
        LocalDateTime localDateTime = LocalDateTime.now();
        System.out.println(localDateTime);// 输出： 2020-07-01T21:56:11.978
        DateTimeFormatter formatter = DateTimeFormatter.ISO_DATE;
        System.out.println(formatter.format(localDateTime));// 输出： 2020-07-01
        formatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH时mm分ss秒");
        System.out.println(formatter.format(localDateTime));// 输出： 2020年07月01日 21时56分11秒
        System.out.println(formatter.parse("2020年07月01日 21时55分08秒"));// 输出： {},ISO resolved to 2020-07-01T21:55:08

        System.out.println(localDateTime.parse("2020年07月01日 21时55分08秒",formatter));// 输出： 2020-07-01T21:55:08

    }

时区的处理

Java8 中加入了对时区的支持，带时区的时间为分别为：ZonedDate、 ZonedTime、 ZonedDateTime。
其中每一个时区都对应着 ID，地区ID都为 “{区域}/{城市}”的格式，例如： Asia/Shanghai 等。get

ZoneId：该类中包含了全部的时区信息
getAvailableZoneIds() : 能够获取全部时区时区信息
of(id) : 用指定的时区信息获取 ZoneId 对象

示例：

    @Test
    public void test8(){
        //时区：ZonedDate、 ZonedTime、 ZonedDateTime

        Set<String> zoneIds = ZoneId.getAvailableZoneIds();//获取全部时区
        System.out.println(zoneIds);//输出： [Asia/Aden, America/Cuiaba, Etc/GMT+9, Etc/GMT+8, Africa/Nairobi, America/Marigot, Asia/Aqtau, .....等等.....
        LocalDateTime localDateTime = LocalDateTime.now();
        System.out.println(localDateTime);// 输出： 2020-07-01T22:06:59.130
        localDateTime = LocalDateTime.now(ZoneId.of("America/Marigot"));
        System.out.println(localDateTime);// 输出： 2020-07-01T10:06:59.131
        localDateTime = LocalDateTime.now(ZoneId.of("Etc/GMT+8"));
        System.out.println(localDateTime);// 输出： 2020-07-01T06:06:59.131
        System.out.println("-------------------------------------------");
        localDateTime = LocalDateTime.now();
        System.out.println(localDateTime);// 输出： 2020-07-01T22:10:39.940
        ZonedDateTime zonedDateTime = localDateTime.atZone(ZoneId.of("Europe/Vatican"));//带时区的日期时间
        System.out.println(zonedDateTime);// 输出： 2020-07-01T22:10:39.940+02:00[Europe/Vatican]

    }