简单使用时间API(LocalDateTime)

r囧r小猫 2023-10-01 10:49 20阅读 0赞

[简单使用时间API(LocalDateTime)][API_LocalDateTime]  
[java获取当前日期和时间（各种方法对比）][java]

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

### 文章目录 ###

*   *  一、新日期时间API介绍
     *  二、获取时间
     *  三、时间格式转换（Date、LocalDateTime）
     *  四、时间格式化与解析
     *  五、修改时间
     *  六、日期时间的比较
     *  七、计算日期时间差
     *  八、时间戳(instant)类
     *  九、时间矫正器(指定某个时间)
     *  十、设置日期时间的时区

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

## 一、新日期时间API介绍 ##

JDK 8中增加了一套全新的日期时间API，这套API设计合理，是线程安全的。新的日期及时间API位于 java.time 包中，下面是一些关键类。

**LocalDate ：** 表示日期，包含年月日，格式为 2019-10-16

\*\*LocalTime ：\*\*表示时间，包含时分秒，格式为 16:38:54.158549300

\*\*LocalDateTime ：\*\*表示日期时间，包含年月日，时分秒，格式为 2018-09-06T15:33:56.750

**DateTimeFormatter ：** 日期时间格式化类。

**Instant：** 时间戳，表示一个特定的时间瞬间。

**Duration：** 用于计算2个时间(LocalTime，时分秒)的距离

**Period：** 用于计算2个日期(LocalDate，年月日)的距离

**ZonedDateTime ：** 包含时区的时间

## 二、获取时间 ##

LocalDate类：

//  LocalDate:获取日期时间信息。(yyyy-MM-dd)
    //  获取指定日期
    LocalDate of = LocalDate.of(1989, 4, 12);
    //  获取当前日期
    LocalDate now = LocalDate.now();
    //  获取日期信息
    int year = now.getYear();
    int monthValue = now.getMonthValue();
    int dayOfMonth = now.getDayOfMonth();
    DayOfWeek dayOfWeek = now.getDayOfWeek();

LocalTime类

//  LocalTime类: 获取时间信息。格式为 16:38:54.158549300
    //  获取指定时间
    LocalTime time = LocalTime.of(12, 13, 35, 129_900_000);
    //  获取当前时间
    LocalTime nowTime = LocalTime.now();
    //  获取时间信息
    int hour = nowTime.getHour();
    int minute = nowTime.getMinute();
    int second = nowTime.getSecond();
    int nano = nowTime.getNano();

LocalDateTime类

//  LocalDateTime类: 获取日期时间信息。格式为 2018-09-06T15:33:56.750
    //  得到指定日期时间
    LocalDateTime dateTime = LocalDateTime.of(1985, 4, 15, 12, 12, 12);
    //  得到当前日期时间
    LocalDateTime localDateTime = LocalDateTime.now();
    //  获取日期时间信息
    int year1 = localDateTime.getYear();
    int monthValue1 = localDateTime.getMonthValue();
    int dayOfMonth1 = localDateTime.getDayOfMonth();
    int hour1 = localDateTime.getHour();
    int minute1 = localDateTime.getMinute();
    int second1 = localDateTime.getSecond();
    int nano1 = localDateTime.getNano();

获取当天的零点(LocalDateTime)

LocalDateTime now = LocalDateTime.now();
    LocalDateTime minDay = LocalDateTime.of(now.toLocalDate(), LocalTime.MIN);

当天的最后时间(LocalDateTime)

LocalDateTime now = LocalDateTime.now();
    LocalDateTime maxOfDay = LocalDateTime.of(now.toLocalDate(), LocalTime.MAX);

## 三、时间格式转换（Date、LocalDateTime） ##

Date转为LocalDateTime

Date date = new Date();
    Instant instant = date.toInstant();
    ZoneId zoneId = ZoneId.systemDefault();
    LocalDateTime localDateTime = instant.atZone(zoneId).toLocalDateTime();

## 四、时间格式化与解析 ##

DateTime类型：

//  得到当前日期时间(yyyy-MM-dd)
    LocalDate now = LocalDate.now();
    DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
    //  将日期时间格式化为字符串(yyyy-MM-dd)
    String format = now.format(formatter);
    //  将字符串解析为日期时间(yyyy-MM-dd)
    LocalDate parse = LocalDate.parse("1999-12-12", formatter);

LocalDateTime类

//  LocalDateTime类: 获取日期时间信息。格式为 2018-09-06T15:33:56.750
    //  得到当前日期时间
    LocalDateTime now = LocalDateTime.now();
    DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
    //  将日期时间格式化为字符串
    String format = now.format(formatter);
    //  将字符串解析为日期时间
    LocalDateTime parse = LocalDateTime.parse("1999-12-12 12:12:12", formatter);

## 五、修改时间 ##

`LocalDateTime类`和`LocalDateTime类`和`LocalDateTime类`：具体方法基本一致，这个只介绍`LocalDateTime`类的使用。

修改时间

//  LocalDateTime类: 获取日期时间信息。格式为 2018-09-06T15:33:56.750
    //  得到当前日期时间
    LocalDateTime localDateTime = LocalDateTime.now();
    //  修改年份
    LocalDateTime setYear = localDateTime.withYear(1995);
    //  修改月份
    LocalDateTime setMonth = localDateTime.withMonth(9);
    //  修改日期
    LocalDateTime setDay = localDateTime.withDayOfMonth(9);
    //  修改小时
    LocalDateTime setHour = localDateTime.withHour(9);
    //  修改分钟
    LocalDateTime setMinute = localDateTime.withMinute(9);
    //  修改秒
    LocalDateTime setSecond = localDateTime.withSecond(9);

增加指定时间

//  加减指定时间
    //  5 年后
    LocalDateTime addYear = localDateTime.plusYears(5);
    //  5 月后
    LocalDateTime addMonth = localDateTime.plusMonths(5);
    //  5 天后
    LocalDateTime addDay = localDateTime.plusDays(5);
    //  5 小时后
    LocalDateTime addHours = localDateTime.plusHours(5);
    //  5 分钟后
    LocalDateTime addMinutes = localDateTime.plusMinutes(5);
    //  5 秒后
    LocalDateTime addSeconds = localDateTime.plusSeconds(5);

减少指定时间

//  10 年前
    LocalDateTime deleteYear = localDateTime.minusYears(10);
    //  10 月前
    LocalDateTime deleteMonth = localDateTime.minusMonths(10);
    //  10 天前
    LocalDateTime deleteDay = localDateTime.minusDays(10);
    //  10 小时前
    LocalDateTime deleteHours = localDateTime.minusHours(10);
    //  10 分钟前
    LocalDateTime deleteMinutes = localDateTime.plusMinutes(10);
    //  10 秒前
    LocalDateTime deleteSeconds = localDateTime.minusSeconds(10);

## 六、日期时间的比较 ##

`LocalDateTime类`和`LocalDateTime类`和`LocalDateTime类`：具体方法基本一致，这个只介绍`LocalDateTime`类的使用。

比较时间的早晚

//  LocalDateTime类: 获取日期时间信息。格式为 2018-09-06T15:33:56.750
    //  得到当前日期时间
    LocalDateTime now = LocalDateTime.now();
    //  10 天后
    LocalDateTime addDay = now.plusDays(10);
    //  true(now 是否早于 addDay)
    boolean before = now.isBefore(addDay);
    System.out.println(before);
    //  false(now 是否晚于于 addDay)
    boolean after = now.isAfter(addDay);
    System.out.println(after);

## 七、计算日期时间差 ##

Duration/Period类: 计算日期时间差。

*  Duration：用于计算2个时间(LocalTime，时分秒)的距离
 *  Period：用于计算2个日期(LocalDate，年月日)的距离
 *  后面的时间减去前年的时间

Duration使用：

LocalDateTime now = LocalDateTime.now();
    //  10 天后
    LocalDateTime addDay = now.plusDays(10);
    //  后面的时间减去前年的时间
    Duration duration = Duration.between(now, addDay);
    //  相差天数
    long differDay = duration.toDays();
    //  相差小时
    long differHours = duration.toHours();
    //  相差分钟
    long differMinutes = duration.toMinutes();

Period使用：

LocalDate nowDate = LocalDate.now();
    LocalDate of = LocalDate.of(1998, 8, 8);
    //	后面的时间减去前年的时间
    Period between = Period.between(nowDate, of);
    //  相差年
    int years = between.getYears();
    //  相差月
    int months = between.getMonths();
    //  相差天
    int days = between.getDays();

## 八、时间戳(instant)类 ##

Instant now = Instant.now();
    // 获取从1970年1月1日 00:00:00的秒
    int nano = now.getNano();
    
    long epochSecond = now.getEpochSecond();
    
    long l = now.toEpochMilli();
    //格式化时间5秒
    Instant instant = Instant.ofEpochSecond(5);

## 九、时间矫正器(指定某个时间) ##

有时我们可能需要获取例如：将日期调整到“下一个月的第一天”等操作。可以通过时间校正器来进行。

*  TemporalAdjuster : 时间校正器。
 *  TemporalAdjusters : 该类通过静态方法提供了大量的常用TemporalAdjuster的实现。

//  LocalDateTime类: 获取日期时间信息。格式为 2018-09-06T15:33:56.750
    //  得到当前日期时间
    LocalDateTime now = LocalDateTime.now();
    TemporalAdjuster temporalAdjuster = new TemporalAdjuster() {
        
        @Override
        public Temporal adjustInto(Temporal temporal) {
        
    //          当前时间
            LocalDateTime temporal1 = (LocalDateTime) temporal;
            return temporal1.plusMonths(1).withDayOfMonth(1);
        }
    };
    //  将当前时间now，矫正为某个指定时间
    LocalDateTime temDateTime = now.with(temporalAdjuster);

## 十、设置日期时间的时区 ##

加入了对时区的支持。

*  不带时区：LocalDate、LocalTime、LocalDateTime。
 *  带时区：ZonedDate、ZonedTime、ZonedDateTime。
 *  其中每个时区都对应着 ID，ID的格式为 “区域/城市” 。例如 ：Asia/Shanghai 等。
 *  `ZoneId`：该类中包含了所有的时区信息。

//  1. 获取所有时区的ID
    ZoneId.getAvailableZoneIds().forEach(System.out::println);
    //  2-1. 使用计算机默认时区(东8区）(2021-12-26T18:18:07.536+08:00[Asia/Shanghai])
    ZonedDateTime bz = ZonedDateTime.now();
    //  2-1. 使用世界标准时间(减8小时)(2021-12-26T10:18:07.537Z)
    ZonedDateTime now = ZonedDateTime.now(Clock.systemUTC());
    //  3. 获取某个ID时区的，当前时间(2021-12-26T04:18:07.538-06:00[America/Guatemala])
    ZonedDateTime now1 = ZonedDateTime.now(ZoneId.of("America/Guatemala"));

[API_LocalDateTime]: https://blog.csdn.net/lydms/article/details/122158647
[java]: https://blog.csdn.net/lydms/article/details/103937041