简单使用时间API(LocalDateTime)

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

---

---

一、新日期时间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"));