# 使用 LocalDateTime 替代 Date

JDK 中的 Date 的缺点：

Date 如果不格式化，打印出的日期可读性差；
使用 SimpleDateFormat 可以对日期时间进行格式化，但是 SimpleDateFormat 并非线性安全；
Date 对时间处理比较麻烦；
Date 这个类名的命名并不严谨。

另外，《阿里巴巴开发手册》中明确禁用 static 关键字修饰 SimpleDateFormat 。

Java 官方请著名的第三方日期时间包 joda-time 的作者重新设计了与日期时间有关的 API 部分，并把它们放在了 jdk 8 的 java.time 包下。

新增了：LocalDate、LocalTime、LocalDateTime 三个类及相关新的 API 用以替代 Date 及其旧的使用方式。

# 1. LocalDate

只会获取 年月日 信息。

LocalDate 中并不包含『时区』信息。即，一个单独的 LocalDate 对象所表达的含义是不严谨的。LocalTime 和 LocalDateTime 也一样。

创建 LocalDate 对象

LocalDate localDate = LocalDate.now();
LocalDate localDate = LocalDate.of(2000, 1, 1);

获取年、月、日、星期几

LocalDate localDate = LocalDate.now();

int year = localDate.getYear();
int year = localDate.get(ChronoField.YEAR);

Month month = localDate.getMonth();
int month = localDate.get(ChronoField.MONTH_OF_YEAR);

int day = localDate.getDayOfMonth();
int day = localDate.get(ChronoField.DAY_OF_MONTH);

DayOfWeek dayOfWeak = localDate.getDayOfWeek();
int dayOfWeak = localDate.get(ChronoField.DAY_OF_WEEK);

# 2. LocalTime

只会获取 时分秒 信息。

创建 LocalTime 对象

LocalTime localTime = LocalTime.now();
LocalTime localTime = LocalTime.of(17, 30, 0);

获取时分秒

int hour = localTime.getHour();
int hour = localTime.get(ChronoField.HOUR_OF_DAY);

int minute = localTime.getMinute();
int minute = localTime.get(ChronoField.MINUTE_OF_HOUR);

int second = localTime.getSecond();
int second = localTime.get(ChronoField.SECOND_OF_MINUTE);

# 3. LocaDateTime

获取 年月日时分秒，等于 LocalDate + LocalTime 。

创建 LocalDateTime

LocalDateTime localDateTime = LocalDateTime.now();
LocalDateTime localDateTime = LocalDateTime.of(2019, Month.SEPTEMBER, 10, 14, 46, 56);
LocalDateTime localDateTime = LocalDateTime.of(localDate, localTime);
LocalDateTime localDateTime = localDate.atTime(localTime);
LocalDateTime localDateTime = localTime.atDate(localDate);

获取 LocalDate

LocalDate localDate = localDateTime.toLocalDate();

获取 LocalTime

LocalTime localTime = localDateTime.toLocalTime();

# 4. Instant

在 Java 中，一个 Instant 对象标识时间轴上的一个点，代表着一个概念上的瞬间。

『原点』是众所周知的 1970 年 1 月 1 日的午夜，此时本初子午线正在穿过伦敦格林威治皇家天文台。从『原点』开始，时间按照每天 86400 秒进行正向、反向计算，向前、向后分别以纳秒为单位。

注意

Instant 是有时区概念的，在你未指定时，它的默认时区时 0 时区，即，格林威治时间。

虽然 Instant 内部是以纳秒为单位进行存储、运算的，但是很显然你可以将它转换成相较于『原点（epoch）』的时、分、秒。

在编程世界中，我们日常生活中所说的『秒』使用的是 second ；而『相较于原点的秒』使用的是 epoch second 。epoch 是时代、纪元等含义。

另外，在 Java 8 中，使用 Duration 对象来代表两个 Instant 之间的时间跨度。

创建 Instant 对象
```
Instant instant = Instant.now();
```

获取秒数

long currentSecond = instant.getEpochSecond();

获取毫秒数
```
long currentMilli = instant.toEpochMilli();
```
个人觉得如果只是为了获取秒数或者毫秒数，使用 System.currentTimeMillis() 来得更为方便。

# 5. 修改 LocalDate、LocalTime、LocalDateTime、Instant

LocalDate、LocalTime、LocalDateTime、Instant 为『不可变对象』，修改这些对象对象会返回一个副本，即生成并返回一个新对象。

增加、减少年数、月数、天数等以 LocalDateTime 为例

LocalDateTime localDateTime = LocalDateTime.of(2019, Month.SEPTEMBER, 10, 14, 46, 56);

// 增加一年
localDateTime = localDateTime.plusYears(1);
localDateTime = localDateTime.plus(1, ChronoUnit.YEARS);

// 减少一个月
localDateTime = localDateTime.minusMonths(1);
localDateTime = localDateTime.minus(1, ChronoUnit.MONTHS);

通过 with 修改某些值

// 修改年为 2019
localDateTime = localDateTime.withYear(2020);
// 修改为 2022
localDateTime = localDateTime.with(ChronoField.YEAR, 2022);

// 还可以修改月、日

# 6. 使用 TemporalAdjuster 和 TemporalAdjusters

有的时候，你需要进行一些更加复杂的日期操作，比如，将日期调整到下个周日、下个工作日，或者是本月的最后一天。这时，你可以使用重载版本的 withXXX 方法，向其传递一个提供了更多定制化选择的 TemporalAdjuster 对象，更加灵活地处理日期。

比如有些时候想知道这个月的最后一天是几号、下个周末是几号，通过提供的时间和日期API可以很快得到答案。

对于最常见的用例，日期和时间 API 已经提供了大量预定义的 TemporalAdjuster 对象。你可以通过 TemporalAdjusters（注意，此处有 s）类的静态工厂方法访问它们。

TemporalAdjusters 类中的常用工厂方法：
- dayOfWeekInMonth 创建一个新的日期，它的值为同一个月中每一周的第几天
- firstDayOfMonth 创建一个新的日期，它的值为当月的第一天
- firstDayOfNextMonth 创建一个新的日期，它的值为下月的第一天
- firstDayOfNextYear 创建一个新的日期，它的值为明年的第一天
- firstDayOfYear 创建一个新的日期，它的值为当年的第一天
- firstInMonth 创建一个新的日期，它的值为同一个月中，第一个符合星期几要求的值
- lastDayOfMonth 创建一个新的日期，它的值为当月的最后一天
- lastDayOfNextMonth 创建一个新的日期，它的值为下月的最后一天
- lastDayOfNextYear 创建一个新的日期，它的值为明年的最后一天
- lastDayOfYear 创建一个新的日期，它的值为今年的最后一天
- lastInMonth 创建一个新的日期，它的值为同一个月中，最后一个符合星期几要求的值
- next / previous 创建一个新的日期，并将其值设定为日期调整后或者调整前，第一个符合指定星期几要求的日期
- nextOrSame / previousOrSame 创建一个新的日期，并将其值设定为日期调整后或者调整前，第一个符合指定星期几要求的日期，如果该日期已经符合要求，直接返回该对象

# 7. 格式化时间

DateTimeFormatter 默认提供了多种格式化方式，如果默认提供的不能满足要求，可以通过 DateTimeFormatter 的 ofPattern 方法创建自定义格式化方式。

LocalDate localDate = LocalDate.of(2019, 9, 10);
String s1 = localDate.format(DateTimeFormatter.BASIC_ISO_DATE);
String s2 = localDate.format(DateTimeFormatter.ISO_LOCAL_DATE);

// 自定义格式化
DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");
String s3 = localDate.format(dateTimeFormatter);

# 8. 解析时间

相较于传统的 SimpleDateFormat，DateTimeFormatter 是线程安全的

LocalDate localDate1 = LocalDate.parse("20190910", DateTimeFormatter.BASIC_ISO_DATE);
LocalDate localDate2 = LocalDate.parse("2019-09-10", DateTimeFormatter.ISO_LOCAL_DATE);

Date 与 LocalDate 互转：

Date 转 LocalDate

// Date 转 LocalDate
public static LocalDate date2LocalDate(Date date) {
  return (date == null) ? (null) : (date.toInstant().atZone(ZoneId.systemDefault()).toLocalDate());
}

LocalDate 转 Date

//  LocalDate转Date
public static Date localDate2Date(LocalDate localDate) {
  return (localDate == null) ? (null) : (Date.from(localDate.atStartOfDay(ZoneId.systemDefault()).toInstant()));
}

# 9. 带时区的时间

LocalDate、LocalTime 和 LocalDateTime 是不带时区信息的。在 JDK 8 中，带有时区信息的日期时间类是 ZonedDateTime 。

因特网编号管理局（IANA）维护着一份全球所有已知时区的数据库（http://www.iana.org/time-zones (opens new window)），每年会更新几次（这些更新主要处理夏令时规则的改变）。Java 就是使用了 IANA 的数据库。

在 Java 中，每个时区都有一个 ID，例如 Asia/Shanghai 。想要获得所有可用的时区，你可以调用 ZoneId.getAvailableZoneIds() 。大概有 600 个。

如果你想获得 ZonedDateTime 对象，你有 2 种途径：

直接使用 ZonedDateTime.of() 方法创建；
先创建一个 LocalDateTime 对象（它不含时区概念），再调用它的 atZone 方法，赋予它时区的概念，生成 ZonedDateTime 对象。

# 10. SpringBoot 中应用 LocalDateTime

# 将 LocalDateTime 字段以时间戳的方式返回给前端。

添加日期转化类：

public class LocalDateTimeConverter extends JsonSerializer<LocalDateTime> {

    @Override
    public void serialize(LocalDateTime value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        gen.writeNumber(value.toInstant(ZoneOffset.of("+8")).toEpochMilli());
    }
}

并在 LocalDateTime 字段上添加 @JsonSerialize(using = LocalDateTimeConverter.class) 注解，如下：

@JsonSerialize(using = LocalDateTimeConverter.class)
protected LocalDateTime gmtModified;

# 将 `LocalDateTime` 字段以指定格式化日期的方式返回给前端

在 LocalDateTime 字段上添加 @JsonFormat(shape=JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss") 注解即可，如下：

@JsonFormat(shape=JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss")
protected LocalDateTime gmtModified;

# 将 LocalDateTime 字段以指定格式化日期的方式返回给前端

在 LocalDateTime 字段上添加 @JsonFormat(shape=JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss") 注解即可，如下：

@JsonFormat(shape=JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss")
protected LocalDateTime gmtModified;

# 对前端传入的日期进行格式化

在 LocalDateTime 字段上添加 @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") 注解即可，如下：

@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
protected LocalDateTime gmtModified;

← 如何正确使用 Optional Java 8 Nashorn JavaScript →