Java 8 LocalDate、LocalTime、LocalDateTime、Instant、DateTimeFormatter

SimpleDateFormat线程不安全

Date如果不格式化，打印出的日期可读性差

Tue Sep 10 09:34:04 CST 2019

使用SimpleDateFormat对时间进行格式化，但SimpleDateFormat是线程不安全的 ，SimpleDateFormat除了format方法是线程不安全以外，parse方法也是线程不安全的

---

SimpleDateFormat如何保证线程安全

• 避免线程之间共享一个SimpleDateFormat对象，每个线程使用时都创建一次SimpleDateFormat对象 =>
  创建和销毁对象的开销大
• 对使用format和parse方法的地方进行加锁 => 线程阻塞性能差
• 使用ThreadLocal保证每个线程最多只创建一次SimpleDateFormat对象 => 较好的方法

---

1、Java8全新的日期和时间API

在使用Java程序操作数据库时，我们需要把数据库类型与Java类型映射起来。下表是数据库类型与Java新旧API的映射关系

数据库	对应Java类（旧）	对应Java类（新）
DATETIME	java.util.Date	LocalDateTime
DATE	java.sql.Date	LocalDate
TIME	java.sql.Time	LocalTime
TIMESTAMP	java.sql.Timestamp	LocalDateTime

---

2、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 day = localDate.getDayOfMonth();
int day1 = localDate.get(ChronoField.DAY_OF_MONTH);
DayOfWeek dayOfWeek = localDate.getDayOfWeek();
int dayOfWeek1 = localDate.get(ChronoField.DAY_OF_WEEK);

---

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

---

4、LocalDateTime

//创建对象
LocalDateTime localDateTime = LocalDateTime.now();
LocalDateTime localDateTime1 = LocalDateTime.of(2019, Month.SEPTEMBER, 10, 14, 46, 56);
//LocalDate+LocalTime-->LocalDateTime
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();

---

5、ZonedDateTime

LocalDateTime总是表示本地日期和时间，要表示一个带时区的日期和时间，我们就需要ZonedDateTime。

可以简单地把ZonedDateTime理解成LocalDateTime加ZoneId。ZoneId是java.time引入的新的时区类，注意和旧的java.util.TimeZone区别。

创建一个ZonedDateTime对象

// 默认时区
ZonedDateTime zbj = ZonedDateTime.now(); 
// 用指定时区获取当前时间
ZonedDateTime zny = ZonedDateTime.now(ZoneId.of("America/New_York")); 

结果：

2019-09-15T20:58:18.786182+08:00[Asia/Shanghai]
2019-09-15T08:58:18.788860-04:00[America/New_York]

时区转换

要转换时区，首先我们需要有一个ZonedDateTime对象，然后，通过withZoneSameInstant()将关联时区转换到另一个时区，转换后日期和时间都会相应调整。

ZonedDateTime zbj = ZonedDateTime.now(ZoneId.of("Asia/Shanghai"));
// 转换为纽约时间:
ZonedDateTime zny = zbj.withZoneSameInstant(ZoneId.of("America/New_York"));

涉及到时区时，千万不要自己计算时差，否则难以正确处理夏令时。有了ZonedDateTime，将其转换为本地时间就非常简单，转换为LocalDateTime时，直接丢弃了时区信息。

ZonedDateTime zdt = ...
LocalDateTime ldt = zdt.toLocalDateTime();

---

6、Instant

 获取秒数或时间戳，System.currentTimeMillis()也可以获取毫秒数

//创建Instant对象
Instant instant = Instant.now();
//获取秒数
long currentSecond = instant.getEpochSecond();
//获取毫秒数
long currentMilli = instant.toEpochMilli();
long l = System.currentTimeMillis();

---

7、日期计算

calDate、LocalTime、LocalDateTime、Instant为不可变对象，修改这些对象对象会返回一个副本

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

//修改LocalDate、LocalTime、LocalDateTime、Instant
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修改某些值
//修改年为2020
localDateTime = localDateTime.withYear(2020);
//修改为2022
localDateTime = localDateTime.with(ChronoField.YEAR, 2022);
//还可以修改月、日

• 获取LocalDateTime对象的属性信息 

 * 1.获取日期时间对象的信息
 *      toLocalDate() : 返回一个LocalDate 对象
 *      toLocalTime() : 返回一个LocalTime 对象
 *
 *      getYear() : 获取年分信息
 *      getMonth() : 获取月份信息（枚举类型）
 *      getMonthValue() : 获取月份的数字（数值类型）
 *      getDayOfMonth() : 获取日期信息
 *      getDayOfWeek() : 获取星期几 （枚举类型）
 *      getDayOfYear() : 获取这一年的第几天
 *
 *      getHour() : 获取小时信息
 *      getMinute() : 获取分钟信息
 *      getSecond() : 获取秒
 *      getNano() :  获取纳秒
 *

• 指定LocalDateTime对象的属性信息

 * 2.指定日期时间对象的 年、月、日、时、分、秒、纳秒
 *      withYear(int) : 指定年分
 *      withMonth(int) : 指定月份
 *      withDayOfMonth(int) : 指定日期
 *      withDayOfYear(int) : 指定一年中的多少天
 *      withHour(int) : 指定小时
 *      withMinute(int) : 指定分钟
 *      withSecond(int) : 指定秒
 *      withNano(int) : 指定纳秒
 *
 *      with(TemporalAdjuster) : 时间矫正器
 *

• 增加/减去 年月日时分秒信息

 * 3.加上 或者 减去 时、分、秒、纳秒
 *         plusYears(long) : 加几年
 *         plusMonths(long) : 加几个月
 *         plusDays(long) : 加几天
 *         plusWeeks(long) : 加几个周
 *         plusHours(long) : 加几个小时
 *         plusMinutes(long) : 加几分钟
 *         plusSeconds(long) : 加几秒
 *         plusNanos(long) : 加几个纳秒
 *
 *         minusYears(long) : 减几年
 *         minusMonths(long) : 减几个月
 *         minusDays(long) : 减几天
 *         minusWeeks(long) : 减几个周
 *         minusHours(long) : 减几个小时
 *         minusMinutes(long) : 减几分钟
 *         minusSeconds(long) : 减几秒
 *         minusNanos(long) : 减几个纳秒
 *

---

8、格式化时间

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

在java8之前我们都用SimpleDateFormat类来进行时间格式化，但这种存在一些缺点：
1.每处理一次时间都new一个SimpleDateFormat实例对象会占用大量的内存和jvm空间
2.为了减少内存开销，我们可以使用static将其设置为共享变量，但SimpleDateFormat是线程不安全的，需要通过加锁的方式来解决
java8之后为我们提供了DateTimeFormatter类代替SimpleDateFormat，这是一个线程安全的格式化工具类。具体使用如下：
 
//字符串转换为日期
String dateStr= "2018年12月18日";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日");
LocalDate date= LocalDate.parse(dateStr, formatter);
 
//日期转换为字符串
LocalDateTime now = LocalDateTime.now();
DateTimeFormatter format = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm:ss");
String nowStr = now.format(format);
 
Instant：瞬时实例。
LocalDate：本地日期，不包含具体时间。
LocalTime：本地时间，不包含日期。
LocalDateTime：组合了日期和时间，但不包含时差和时区信息。
ZonedDateTime：最完整的日期时间，包含时区和相对UTC或格林威治的时差。
 
//Date转LocalDateTime
Instant instant = date.toInstant();
ZoneId zoneId = ZoneId.systemDefault();
Date date = instant.atZone(zoneId).toLocalDateTime();
 
//LocalDateTime转Date
ZoneId zoneId = ZoneId.systemDefault();
ZonedDateTime zdt = localDateTime.atZone(zoneId);
LocalDateTime localDateTime = Date.from(zdt.toInstant());

---

9、日期比较

1.字符串String的日期比较

String型的日期通过compareTo()来比较，因为String实现了comparable接口

• endDate.compareTo(startDate) 结果>0 说明前者 晚于 后者

String startDate="2022-05-31 00:00:00";

//java7
String endDate= new SimpleDateFormat("yyyy-MM-dd hh:mm:ss").format(new Date());
System.out.println(endDate.compareTo(startDate));


// java8
LocalDateTime now = LocalDateTime.now();
DateTimeFormatter format = DateTimeFormatter.ofPattern("yyyy-MM-dd hh:mm:ss");
String endDate= now.format(format);
System.out.println(endDate.compareTo(startDate));

返回结果是1,即 endDate>startDate

// 比较的字符串格式要一致，yyyy-MM-dd hh:mm:ss 和 yyyyMMddhhmmss 格式是不一样的，这么比较结果肯定不对

2.数值型long比较

• long time=System.currentTimeMillis() 获取系统当前时间，精确到毫秒
• long today= Date.getTime()，即通过Date型日期调用getTime()方法获取，精确到毫秒
• Instant instant = Instant.now();
  //获取毫秒数
  long currentMilli = instant.toEpochMilli();

String startDate="2020-11-13 00:00:00";
String endDate= "2020-11-14 23:59:59";
SimpleDateFormat simpleDateFormat=new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
try{
    Date date01=simpleDateFormat.parse(startDate);
    Date date02=simpleDateFormat.parse(endDate);
	
	// 精确到毫秒
    long milliSecond01=date01.getTime();
    long milliSecond02=date02.getTime();
	
	// true
    System.out.println(milliSecond02 > milliSecond01);
}catch (Exception e){

}

String startDate="2020-11-13 00:00:00";
String endDate= "2020-11-14 23:59:59";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd hh:mm:ss");
LocalDateTime startDate = LocalDateTime .parse(startDate, formatter);
LocalDateTime endDate = LocalDateTime .parse(endDate, formatter);

3.日期型Date直接比较

日期型Date的比较通过before()和after()来完成，返回值均为boolean

String startDate="2020-11-13 00:00:00";
String endDate= "2020-11-14 23:59:59";
SimpleDateFormat simpleDateFormat=new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
try{
    Date date01=simpleDateFormat.parse(startDate);
    Date date02=simpleDateFormat.parse(endDate);
	
	// true , 11-13号 在 11-14号 之前 
   	System.out.println(date01.before(date02));
}catch (Exception e){

}