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

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

日期和时间

Java 新的日期工具类在 java.time 包及子包中 ,日期类主要有 LocalDateTimeLocalDateLocalTime ,这三个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表达式参照表:

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


除非注明,否则均为"攻城狮·正"原创文章,转载请注明出处。

本文链接:https://engr-z.com/207.html

发表评论

邮箱地址不会被公开。