Java8 时间接口的使用与转化

前言

《阿里巴巴Java开发手册》第一章并发处理
⑤【强制】SimpleDateFormat是线程不安全的类，一般不要定义为static变量，如果定义为static，必须加锁，或者使用DateUtils工具类。
正例：注意线程安全，使用DateUtils。推荐如下处理

private static final ThreadLocal<DateFormat> df = new ThreadLocal<DateFormat>() {
    @Override
    protected DateFormat initialValue() {
        return new SimpleDateFormat("yyyy-MM-dd");
    }
}

说明：如果JDK8的应用，可以使用Instant代替Date，LocalDateTime代替Calender,DateTimeFormatter代替SimpleDateFormat, 官方给出的解释：simple beautiful strong immutable thread-safe

Java8 时间新特性

java.time 包下
LocalDate
LocalTime
LocalDateTime

Date 弊端

Date对时间处理比较麻烦，比如想获取某年、某月、某星期，以及n天以后的时间，getYear、getMonth这些方法获取年月日很Easy，但目前都被弃用了
Date如果不格式化，打印出的日期可读性差

SimpleDateFormat 弊端

线程不安全原因
核心源代码

private StringBuffer format(Date date, StringBuffer toAppendTo,FieldDelegate delegate) {
        // Convert input date to time field list
        calendar.setTime(date);

        boolean useDateFormatSymbols = useDateFormatSymbols();

        for (int i = 0; i < compiledPattern.length; ) {
            int tag = compiledPattern[i] >>> 8;
            int count = compiledPattern[i++] & 0xff;
            if (count == 255) {
                count = compiledPattern[i++] << 16;
                count |= compiledPattern[i++];
            }

            switch (tag) {
            case TAG_QUOTE_ASCII_CHAR:
                toAppendTo.append((char)count);
                break;

            case TAG_QUOTE_CHARS:
                toAppendTo.append(compiledPattern, i, count);
                i += count;
                break;

            default:
                subFormat(tag, count, delegate, toAppendTo, useDateFormatSymbols);
                break;
            }
        }
        return toAppendTo;
    }

calendar是共享变量，并且这个共享变量没有做线程安全控制。当多个线程同时使用SimpleDateFormat对象，如用static修饰的SimpleDateFormat调用format方法时，多个线程会同时调用calendar.setTime方法，可能一个线程刚设置好time值，另外的一个线程马上把设置的time值给修改了导致返回的格式化时间可能是错误的。SimpleDateFormat除了format是线程不安全以外，parse方法也是线程不安全的。

因此，若使其保证线程安全有以下方法

每个线程都创建一次SimpleDateFormat对象
弊端：致使其创建和销毁对象的开销很大
对使用format和parse方法的地方进行加锁
弊端：线程阻塞性能差
使用ThreadLocal保证每个线程最多只创建一次SimpleDateFormat对象

LocalDate

只会获取年月日
创建LocalDate

//获取当前年月日
LocalDate localDate = LocalDate.now();
//构造指定的年月日
LocalDate localDate1 = LocalDate.of(2019, 9, 10);

获取年、月、日、星期几

int year = localDate.getYear();
int year1 = localDate.get(ChronoField.YEAR);
Month month = localDate.getMonth();
int month1 = localDate.get(ChronoField.MONTH_OF_YEAR);
int month2 = localDate.getMonthValue();
int day = localDate.getDayOfMonth();
int day1 = localDate.get(ChronoField.DAY_OF_MONTH);
DayOfWeek dayOfWeek = localDate.getDayOfWeek();
int dayOfWeek1 = localDate.get(ChronoField.DAY_OF_WEEK);

LocalTime

只会获取几点几分几秒
创建LocalTime

LocalTime localTime = LocalTime.of(13, 51, 10);
LocalTime localTime1 = LocalTime.now();

获取时分秒

//获取小时
int hour = localTime.getHour();
int hour1 = localTime.get(ChronoField.HOUR_OF_DAY);
//获取分
int minute = localTime.getMinute();
int minute1 = localTime.get(ChronoField.MINUTE_OF_HOUR);
//获取秒
int second = localTime.getSecond();
int second1 = localTime.get(ChronoField.SECOND_OF_MINUTE);

LocalDateTime

获取年月日时分秒，等于LocalDate+LocalTime
创建LocalDateTime

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

获取LocalDate

LocalDate localDate2 = localDateTime.toLocalDate();

获取LocalTime

LocalTime localTime2 = localDateTime.toLocalTime();

Instant

获取秒数
创建Instant对象

Instant instant = Instant.now();

获取秒数

long currentSecond = instant.getEpochSecond();

获取毫秒数

long currentMilli = instant.toEpochMilli();

修改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);
//修改月份
localDateTime  = localDateTime.withMonth(01);

还可以修改月、日

时间计算

比计算这个月的最后一天是几号、下个周末是几号，通过提供的时间和日期API可以很快得到答案

LocalDate localDate = LocalDate.now();
LocalDate localDate1 = localDate.with(firstDayOfYear());
date.lengthOfMonth()  //  本月多少天
date.lengthOfYear()  //  今年多少天
date.getDayOfWeek()  //  周
date.getDayOfWeek().getValue()  //  本周第几天
date.getDayOfYear()  //  今年第几天
date.isLeapYear()  //  是否是闰年
/*-- 日期比较 --*/
LocalDate date2 = LocalDate.of(2019, 10, 30);
date.isAfter(date2)  //  date在之后
date.isBefore(date2)  //  date在之前

通过firstDayOfYear()返回了当前日期的第一天日期

格式化时间

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);

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

解析时间

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

将LocalDateTime字段以指定格式化日期的方式返回给前端在LocalDateTime字段上添加

@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;

兼容老项目

将java.util.Date转换为java.time.LocalDate

在Java 8 中，java.util.Date类中添加了一个新的方法toInstant()
当转换为Instant对象时，需要通过ZoneId来指定时区。因为Instant只是表示偏移时间。Instant对象的atZone(ZoneId区域)方法返回ZonedDateTime。

然后，使用toLocalDate()方法从中提取LocalDate。
将Date对象转换为系统默认时区的工具方法（转换为LocalDateTime类似）

public static LocalDate convertToLocalDateViaInstant(Date dateToConvert) {
  return dateToConvert.toInstant()
    .atZone(ZoneId.systemDefault())
    .toLocalDate();
}

旧的java.sql.Date类如何转换为LocalDate

Java 8 中, 在java.sql.Date上找到一个额外的 toLocalDate() 方法。也不需要担心时区的问题。

public LocalDate convertToLocalDateFromSqlDate(Date dateToConvert) {
    return new java.sql.Date(dateToConvert.getTime()).toLocalDate();
}

java.time.LocalDate 转换为 java.util.Date

使用 java.sql.Date 对象中提供的新的 valueOf（LocalDate date）方法，默认使用本地时区进行转换（LocalDateTime类似）

public Date convertToDateViaSqlDate(LocalDate dateToConvert) {
    return java.sql.Date.valueOf(dateToConvert);
}

使用 Instant 对象，将其传递给 java.util.Date 对象的 from 方法

public static Date convertToDateByInstant(LocalDate dateToConvert) {
  return java.util.Date.from(dateToConvert.atStartOfDay()
                             .atZone(ZoneId.systemDefault())
                             .toInstant());
}

本文章为网上资料综合整理，侵删