Java 日期时间工具包 – java.time

从JDK8开始，Java 提供了新的日期时间处理方法用来代替旧的日期类(Date)。本章主要讲它们的用法以及和旧日期类互转。

日期和时间

Java 新的日期工具类在 java.time 包及子包中 ，日期类主要有 LocalDateTime、LocalDate、LocalTime ，这三个API类很相似，以下是常用API及说明。

now()
静态方法，获取当前时间日期。示例：LocalDateTime.now()

of()
静态方法，指定日期时间生成LoalDateTime。示例：LocalDateTime.of(2020, 2, 9, 8, 0, 0)。如果是LocalDate，则只能指定年月日。如果是LocalTime则只能指定时分秒。

plus()
在当前时间的基础上增加时间并返回新的LocalDateTime，不会改变原来时间。一般使用以下方法处理更简单：

方法	说明	备注
plusYears(1)	增加1年	LocalTime无此方法
plusMonths(1)	增加1个月	LocalTime无此方法
plusWeeks(1)	增加1周	LocalTime无此方法
plusDays(1)	增加1天	LocalTime无此方法
plusHours(1)	增加1小时	LocalDate无此方法
plusMinutes(1)	增加1分钟	LocalDate无此方法
plusSeconds(1)	增加1秒	LocalDate无此方法

minus()
在当前时间的基础上减去时间并返回新的LocalDateTime，不会改变原来时间。一般使用以下方法处理更简单：

方法	说明	备注
minusYears(1)	减少1年	LocalTime无此方法
minusMonths(1)	减少1个月	LocalTime无此方法
minusWeeks(1)	减少1周	LocalTime无此方法
minusDays(1)	减少1天	LocalTime无此方法
minusHours(1)	减少1小时	LocalDate无此方法
minusMinutes(1)	减少1分钟	LocalDate无此方法
minusSeconds(1)	减少1秒	LocalDate无此方法

---

从上面几个示例可以看到这三个类的区别，LocalDate不能处理时间，LocalTime不能处理日期，LocalDateTime是LocalDate和LocalTime的集合。

• 获取从1970-01-01 00:00:00到当前对象时间的毫秒数：

LocalDateTime.now().toInstant(ZoneOffset.of("+8")).toEpochMilli();

如果是LocalDate或LocaTime需要转换成LocalDateTime对象，再获取毫秒数

• LocalDate转LocalDateTime

// atTime()可以提定时间(时,分,秒)，也可以传LocalTime对象
LocalDate.now().atTime(0, 0, 0);
// 如果不需要指定当天时间，使用该方法指定时分秒为都为0
LocalDate.now().atStartOfDay();

• LocalTime转LocalDateTime

LocalTime.now().atDate(LocalDate.now());

atDate()传入LocalDate对象

• LocalDateTime转LocalDate和LocalTime

// 获得日期
LocalDate date = LocalDateTime.now().toLocalDate();
// 获得时间
LocalTime time = LocalDateTime.now().toLocalTime();

• LocalDateTime与Date互转

/**
 * LocalDateTime转udate
 * @param datetime
 * @return
 */
public static Date localDateTimeToUDate(LocalDateTime datetime) {

    ZoneId zone = ZoneId.systemDefault();
    Instant instant = datetime.atZone(zone).toInstant();
    Date udate = Date.from(instant);
    return udate;
}

/**
 * udate转LocalDateTime
 * @param date
 * @return
 */
public static LocalDateTime uDateToLocalDateTime(Date date) {

    Instant instant = date.toInstant();
    ZoneId zone = ZoneId.systemDefault();
    LocalDateTime localDateTime = LocalDateTime.ofInstant(instant, zone);
    return localDateTime;
}

时区

如果系统有境外用户，可能需要针对各地区不同时区处理。Java中使用的是格林时间(UTC)，我们可以使用 ZoneOffset 设置偏移位置。

// ZoneOffset.of("+8") 等价 ZoneOffset.ofHours(8)
LocalDateTime.now().toInstant(ZoneOffset.of("+8")).toEpochMilli();

格式化

在旧的Date类，使用 SimpleDateFormat 格式化日期，该类不是线程安全的。在新的日期类中使用 DateTimeFormatter

LocalDateTime now = LocalDateTime.now();
DateTimeFormatter formatter = DateTimeFormatter.ISO_DATE_TIME;
log.info("-> {}", formatter.format(now));

DateTimeFormatter 定义好一些预格式化方式，以下是参照表：

还可以自定义格式：

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
// 格式化
String str = formatter.format(LocalDateTime.now());
// 转成LocalDateTime
LocalDateTime datetime = LocalDateTime.parse("2021-01-01 08:00:00", formatter);

以下是Pattern表达式参照表：

新的时间工具虽然复杂了些，但也更加灵活。以后的开发推荐使用新的工具包。