Java 8的日期和时间 API

我是小黑，一名在互联网“苟且”的程序员

关注同名公众号【小黑说Java】，更多干货内容抢先送达，更有不定期抽奖送书活动。

流水不争先，贵在滔滔不绝

前言

在Java8中，不仅推出了Lambda表达式、streams流以及一些优化，对于日期和时间的处理也推出了全新的API。

本文将带大家全面的了解新的日期和时间API的使用。

LocalDate

Java8中的Date/Time API都放在java.time包中；LocalDate表示一个只有年-月-日的日期对象，我们看一下如何来创建一个LocalDate对象：

// 当前日期
LocalDate now = LocalDate.now();
// 2021-10-14
LocalDate.of(2021, Month.OCTOBER, 14);
// 2021-10-14 月份从1开始
LocalDate.of(2021, 10, 14);
// 表示2021年的第20天 2021-01-20
LocalDate.ofYearDay(2021, 20);
// 1970-10-28 代表1970-01-01开始多少天
LocalDate.ofEpochDay(300);
// 代表1970-01-01
LocalDate.ofEpochDay(0);
// 代表1969-12-31
System.out.println(LocalDate.ofEpochDay(-1));

LocalTime和LocalDateTime

LocalTime和LocalDateTime的使用方式和LocalDate类似，LocalTime对象只有时间部分（时-分-秒），LocalDateTime则包含日期和时间。

// 当前时间  14:05:15.986
LocalTime.now();
// 13:20
LocalTime.of(13, 20);
// 13:20:59
LocalTime time = LocalTime.of(13, 20, 59);
// 13:20:59.000000300 最后一个参数为纳秒值
LocalTime.of(13, 20, 59, 300);
// 10:00
LocalTime.ofSecondOfDay(3600 * 10);
// 00:00:00.000010 表示00:00:00.000经过的纳秒
LocalTime.ofNanoOfDay(10000);

// 当前时间 e.g. 2021-10-14 12:13:14.010
LocalDateTime now = LocalDateTime.now();
// 2021-10-14 12:30
LocalDateTime secondOct2021 = LocalDateTime.of(2021, 10, 14, 12, 30);
// 2021-10-01 12:00
LocalDateTime guoqing2021 = LocalDateTime.of(2021, Month.OCTOBER, 1, 12, 0);

默认情况下，LocalDate/Time类使用操作系统时钟的默认时区，我们可以通过提供时区或替代时钟实现来改变这一点。

// 获取亚洲/重庆时区的当前时间
LocalTime currTimeInCq = LocalTime.now(ZoneId.of("Asia/Chongqing"));
// 指定系统时钟为UTC
LocalTime nowInUtc = LocalTime.now(Clock.systemUTC());

我们也可以按需要获取LocalDate/Time对象中的属性，比如：

// 2021-10-14
LocalDate date = LocalDate.of(2021, Month.OCTOBER, 14);

// 判断
boolean isBefore = LocalDate.now().isBefore(date);
// 月份信息
Month october = date.getMonth(); // OCTOBER
int februaryIntValue = october.getValue(); // 10
// 如果是2月则最小值为28，最大值为29
int minLength = october.minLength(); // 31
int maxLength = october.maxLength(); // 31
// 10月所在季度的第一个月
Month firstMonthOfQuarter = october.firstMonthOfQuarter();
// 获取年
int year = date.getYear();
// 日期在当年的第多少天
int dayOfYear = date.getDayOfYear();
// 当年天数
int lengthOfYear = date.lengthOfYear();
// 是否闰年
boolean isLeapYear = date.isLeapYear();
// 获取星期信息
DayOfWeek dayOfWeek = date.getDayOfWeek();
// 当天是星期几
int dayOfWeekIntValue = dayOfWeek.getValue();
// 星期的名称 THURSDAY
String dayOfWeekName = dayOfWeek.name();
// 当月几号
int dayOfMonth = date.getDayOfMonth();
// LocalDate与一个LocalTime组合，LocalTime为00:00:00
LocalDateTime startOfDay = date.atStartOfDay();

LocalTime time = LocalTime.of(15, 30);
int hour = time.getHour(); // 15
int second = time.getSecond(); // 0
int minute = time.getMinute(); // 30
// 将时间转换成对应的秒数
int secondOfDay = time.toSecondOfDay(); // 55800

有些信息可以在不提供具体日期的情况下获得。例如，如果需要关于特定年份的信息，可以使用Year类。

Year currentYear = Year.now();
Year yearOf2021 = Year.of(2021);
// 是否闰年
boolean isLeap = currentYear.isLeap();
// 当年的天数
int length = currentYear.length(); 
// 2021年的第100天
LocalDate date = Year.of(2021).atDay(100);

我们可以使用加减法来增加或减少特定的时间。但是需要注意这些方法会返回一个新的实例，并不会改变原对象的值(Java 8日期/时间类是不可变的)。

LocalDate tomorrow = LocalDate.now().plusDays(1);
// 5小时30分前
LocalDateTime dateTime = LocalDateTime.now().minusHours(5).minusMinutes(30);

TemporalAdjusters是另一种处理日期的好方法。TemporalAdjuster是一个单独的方法接口，用于将调整过程与实际的日期/时间对象分开。可以使用TemporalAdjusters的静态方法访问一组通用的TemporalAdjusters。

LocalDate date = LocalDate.of(2021, Month.FEBRUARY, 25); // 2021-02-25
// 2021-02的第一天 2021-02-01
LocalDate firstDayOfMonth = date.with(TemporalAdjusters.firstDayOfMonth());
// 2021-02的最后一天 2021-02-28
LocalDate lastDayOfMonth = date.with(TemporalAdjusters.lastDayOfMonth());

Time Zones

时区是新API简化的另一个重要主题。到目前为止，我们看到的LocalDate/Time类并不包含有关时区的信息。如果我们想处理某个时区的日期/时间，我们可以使用ZonedDateTime或OffsetDateTime。

// 可用时区集合
Set<String> allZoneIds = ZoneId.getAvailableZoneIds();

ZoneId shanghai = ZoneId.of("Asia/Shanghai");
ZoneId hongkong = ZoneId.of("Asia/Hong_Kong");
// 2021-10-14 12:00
LocalDateTime dateTime = LocalDateTime.of(2021, 10, 14, 12, 0);
// 2021-10-14 12:00对应的香港时间
ZonedDateTime hongkongDateTime = ZonedDateTime.of(dateTime, hongkong);
// hongkongDateTime转换我上海时区
ZonedDateTime shanghaiDateTime = hongkongDateTime.withZoneSameInstant(shanghai);
// 上海时区时间偏移的总秒数
int offsetInSeconds = shanghaiDateTime.getOffset().getTotalSeconds(); 

// 使用offsets
LocalDateTime date = LocalDateTime.of(2021, Month.OCTOBER, 14, 13, 30);
ZoneOffset offset = ZoneOffset.of("+05:00");
// 2021-10-14 13:30+05:00
OffsetDateTime plusFive = OffsetDateTime.of(date, offset);
// 2021-10-14 10:30-02:00
OffsetDateTime minusTwo = plusFive.withOffsetSameInstant(ZoneOffset.ofHours(-2));

Timestamps

LocalDate/Time和ZonedTime这些类提供的是偏向于开发人员的视角表示时间，然而在开发中我们时常需要从计算机的角度看待时间。可以使用代表时间戳的类Instant。

一个Instant对象表示从1970-01-01 00:00:00开始的秒数。如果要表示1970-01-01 00:00:00以前的时间则Instant的值为负数。

// current time
Instant now = Instant.now();
// 通过unix时间戳转换
Instant fromUnixTimestamp = Instant.ofEpochSecond(1262347200);
// 通过毫秒值时间戳转换
Instant fromEpochMilli = Instant.ofEpochMilli(1262347200000l);
// 通过 ISO 8601格式转换
Instant fromIso8601 = Instant.parse("2021-10-01T12:00:00Z");
// toString() 返回的格式是 ISO 8601 标准, e.g. 2021-10-01T01:02:03Z
String toIso8601 = now.toString();
// 转换为unix时间戳
long toUnixTimestamp = now.getEpochSecond();
// 转换为毫秒时间戳
long toEpochMillis = now.toEpochMilli();
// 加减方法
Instant nowPlusTenSeconds = now.plusSeconds(10);
Instant nowMinusTenSeconds = now.minusSeconds(10);

Period和Duration

Period和Duration代表的是一个时间区间。Period使用基于日期的值(年、月、日)，而Duration使用秒或纳秒来定义时间量。

如果时间段的结束时间在开始时间之前，Period和Duration也可以用负值来表示。

Period

LocalDate firstDate = LocalDate.of(2010, 1, 7); // 2010-01-07
LocalDate secondDate = LocalDate.of(2020, 3, 7); // 2020-03-07
Period period = Period.between(firstDate, secondDate);
// 日区间
int days = period.getDays(); // 0
// 月区间
int months = period.getMonths(); // 2
// 年区间
int years = period.getYears(); // 10
// 检查三段区间是否有负值
boolean isNegative = period.isNegative(); // false

// 表示期间2个月零5天
Period twoMonthsAndFiveDays = Period.ofMonths(2).plusDays(5);
// 2021-01-06
LocalDate sixthOfJanuary = LocalDate.of(2021, 1, 6);
// 2021-01-06加2个月零5天  2021-03-11
LocalDate eleventhOfMarch = sixthOfJanuary.plus(twoMonthsAndFiveDays);

Duration

// durations
Instant firstInstant = Instant.ofEpochSecond(1294881180); // 2011-01-13 01:13
Instant secondInstant = Instant.ofEpochSecond(1294708260); // 2011-01-11 01:11
Duration between = Duration.between(firstInstant, secondInstant);
// 因为secondInstant在firstInstant前面，所以这个值是负值
long seconds = between.getSeconds();
// 区间值的绝对值对应的分钟数
long absoluteResult = between.abs().toMinutes();
// 2个小时对应的秒数 7200
long twoHoursInSeconds = Duration.ofHours(2).getSeconds();

格式化和解析

对日期进行格式化，和将字符串解析为日期时间对象是很重要并且常用的一部分。可以通过使用format()和parse()方法来实现：

format

// 2021-10-14 10:45
LocalDateTime dateTime = LocalDateTime.of(2021, Month.OCTOBER, 14, 10, 45);
// ISO基本时间格式 20211014
String asBasicIsoDate = dateTime.format(DateTimeFormatter.BASIC_ISO_DATE);
System.out.println(asBasicIsoDate);
// ISO 周格式时间2021-W41-4
String asIsoWeekDate = dateTime.format(DateTimeFormatter.ISO_WEEK_DATE);
// ISO date time (2021-10-14T10:45:00)
String asIsoDateTime = dateTime.format(DateTimeFormatter.ISO_DATE_TIME);

// 用户自定义格式 14/10/2021
String asCustomPattern = dateTime.format(DateTimeFormatter.ofPattern("dd/MM/yyyy"));

parse

// 解析
LocalDate fromIsoDate = LocalDate.parse("2021-10-14");
// 通过ISO 周格式解析
LocalDate fromIsoWeekDate = LocalDate.parse("2021-W41-4", DateTimeFormatter.ISO_WEEK_DATE);
// 通过用户自定义格式解析
LocalDate fromCustomPattern = LocalDate.parse("2021-10-14", DateTimeFormatter.ofPattern("yyyy-MM-dd"));

转换

当然我们在开发中并不是所有的日期类型都是LocalDate/Time类，需要与java.util.Date类才是我们最常用的，那么要如何将LocalDate/Time类和Date类之间转换呢？

// LocalDate/LocalTime 转换 LocalDateTime
LocalDate date = LocalDate.now();
LocalTime time = LocalTime.now();
LocalDateTime dateTimeFromDateAndTime = LocalDateTime.of(date, time);
LocalDate dateFromDateTime = LocalDateTime.now().toLocalDate();
LocalTime timeFromDateTime = LocalDateTime.now().toLocalTime();

// Instant 转换 LocalDateTime
Instant instant = Instant.now();
LocalDateTime dateTimeFromInstant = LocalDateTime.ofInstant(instant, ZoneId.of("Asia/Shanghai"));
Instant instantFromDateTime = LocalDateTime.now().toInstant(ZoneOffset.ofHours(-2));

// 转换date/calendar/timezone类
Instant instantFromDate = new Date().toInstant();
Instant instantFromCalendar = Calendar.getInstance().toInstant();
ZoneId zoneId = TimeZone.getDefault().toZoneId();

ZonedDateTime zonedDateTimeFromGregorianCalendar = new GregorianCalendar().toZonedDateTime();

// 转换为Date/TimeZone/Calendar
Date dateFromInstant = Date.from(Instant.now());
TimeZone timeZone = TimeZone.getTimeZone(ZoneId.of("America/Shanghai"));
GregorianCalendar gregorianCalendar = GregorianCalendar.from(ZonedDateTime.now());

总结

如果你的Java版本是Java 8或更高版本，那么久可以使用新的API来进行日期和时间的处理，可以替代原来的旧API，如java.util.Date或java.util.Calendar。

建议收藏本文，方便你使用Java 8日期时间API时查阅，希望对你有所帮助。

我是小黑，一名在互联网“苟且”的程序员

关注同名公众号【小黑说Java】，更多干货内容抢先送达，更有不定期抽奖送书活动。

流水不争先，贵在滔滔不绝