一、Java8之前日期类所存在的问题
在Java8之前通常会使用Date结合 SimpleDateFormat、Calender来处理时间和日期的相关需求。
但是这些API也存在明显的缺点:
- 可读性差、易用性差、使用起来冗余繁琐
- java.util.Date 是非线程安全的
- java.util.Date 存在千年虫问题、并且不支持国际化和时区、故大部分方法被声明为过时、不建议再使用
- java.util和java.sql两包中都有Date类,设计上并不合理
而java8在java.time包下重新实现了日期相关类。
每个类功能明确清晰、类之间协作简单、API 定义清晰、功能强大无需借助外部工具类,并且线程安全。
二、Java8新增日期类
Java8新增的日期类主要有三个:
- LocalDate:表示日期(年月日)
- LocalTime
- LocalDateTime:表示时间+ 日期 (年月日时分秒),是java8最常用的日期类
这些类使用了final来修饰,使得这些类是不可变的,一旦实例化,值就固定了,有点类似于String类。
因此它们都是线程安全的。
2.1 LocalDate
1)创建方法
LocalDate now1 = LocalDate.now(); // 当前日期
LocalDate now2 = LocalDate.now(ZoneId.of("Asia/Shanghai")); // 当前日期 (指定时区)
LocalDate now3 = LocalDate.now(Clock.systemDefaultZone()); // 当前日期 (指定时钟)
LocalDate localDate = LocalDate.of(2023, 1, 1); // 指定日期 2023-01-01
2)获取方法
LocalDate now = LocalDate.now();
int year = now.getYear(); // 获取年份
int month = now.getMonthValue(); // 获取月份(1-12)
Month monthEnum = now.getMonth(); // 获取月份的枚举值
int dayOfMonth = now.getDayOfMonth(); // 获取月份中的第几天(1-31)
int dayOfYear = now.getDayOfYear(); // 获取一年中的第几天(1-366)
DayOfWeek dayOfWeek = now.getDayOfWeek(); // 获取现在是星期几
int dayOfYear = now.getDayOfYear(); // 获取一年中的第几天(1-366)
int lengthOfYear = now.lengthOfYear(); // 获得当年总天数
int lengthOfMonth = now.lengthOfMonth(); // 获得当月总天数
long epochDay = now.toEpochDay(); // 与时间纪元(1970年1月1日)相差的天数
3)运算方法
LocalDate now = LocalDate.now();
LocalDate localDate1 = now.plusDays(1); // 给当前时间加一天
LocalDate localDate2 = now.plusDays(1); // 给当前时间加一周
LocalDate localDate3 = now.plusMonths(1); // 给当前时间加一月
LocalDate localDate4 = now.plusYears(1); // 给当前时间加一年
LocalDate localDate5 = now.minusDays(1); // 给当前时间减一天
LocalDate localDate6 = now.minusWeeks(1); // 给当前时间减一周
LocalDate localDate7 = now.minusMonths(1); // 给当前时间减一月
LocalDate localDate8 = now.minusYears(1); // 给当前时间减一年
4)修改方法
LocalDate now = LocalDate.now();
LocalDate localDate1 = now.withYear(2020); // 修改日期对象年份为2020
LocalDate localDate2 = now.withMonth(1); // 修改日期对象月份为1
LocalDate localDate3 = now.withDayOfMonth(1); // 修改日期对象的日期(一月中的第几天)
LocalDate localDate4 = now.withDayOfYear(1); // 修改日期对象的日期(一年中的第几天)
5)比较方法
LocalDate now = LocalDate.now();
LocalDate localDate = LocalDate.of(2023, 1, 1)
boolean isBefore = localDate.isBefore(now); // localDate是否在当天之前
boolean isAfter = localDate.isAfter(now); // localDate是否在当天之后
boolean isEqual = localDate.isEqual(now); // localDate是否在当天
boolean isLeapYear = localDate.isLeapYear(); // localDate是否是闰年
6)LocalDate 与 Date之间的转换
/**
* LocalDate转Date
* @param localDate
* @return
*/
public static Date toDate(LocalDate localDate) {
return Date.from(localDate.atStartOfDay().atZone(ZoneId.systemDefault()).toInstant());
}
/**
* Date转LocalDate
* @param Date
* @return
*/
public static Date toLocalDate(Date date) {
return date.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();
}
7)LocalDate 与 String之间的转换
/**
* String转LocalDate
* @param dateStr 日期的字符串
* @param pattern 格式示例: yyyy-MM-dd
* @return
*/
public static LocalDate toLocalDate(String dateStr, String pattern) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
return LocalDate.parse(dateStr, formatter);
}
/**
* LocalDate转String
* @param localDate localDate对象
* @param pattern 格式示例: yyyy-MM-dd
* @return
*/
public static String LocalDatetoStr(LocalDate localDate, String pattern) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
return localDate.format(formatter);
}
2.2 LocalTime
1)创建方法
LocalTime now1 = LocalTime.now(); // 当前时间
LocalTime now2 = LocalTime.now(ZoneId.of("Asia/Shanghai")); // 当前时间 (指定时区)
LocalTime now3 = LocalTime.now(Clock.systemDefaultZone()); // 当前时间 (指定时钟)
LocalTime localTime = LocalTime.of(9, 9, 9); // 指定时间 09:09:09
2)获取方法
LocalTime now = LocalTime.now();
int hour = now.getHour(); // 获取小时
int minute = now.getMinute(); // 获取小时
int second = now.getSecond(); // 获取秒
int nano = now.getNano(); // 获取纳秒
3)运算方法
LocalTime now = LocalTime.now();
LocalTime localTime1 = now.plusHours(1); // 给当前时间加一小时
LocalTime localTime2 = now.plusMinutes(1); // 给当前时间加一分钟
LocalTime localTime3 = now.plusSeconds(1); // 给当前时间加一秒
LocalTime localTime4 = now.plusNanos(1); // 给当前时间加一纳秒
LocalTime localTime1 = now.minusHours(1); // 给当前时间减一小时
LocalTime localTime2 = now.minusMinutes(1); // 给当前时间减一分钟
LocalTime localTime3 = now.minusSeconds(1); // 给当前时间减一秒
LocalTime localTime4 = now.minusNanos(1); // 给当前时间减一纳秒
4)修改方法
LocalTime now = LocalTime.now();
LocalDate localTime1 = now.withHour(1); // 修改时间对象小时为1
LocalDate localTime2 = now.withMinute(1); // 修改时间对象分钟为1
LocalDate localTime3 = now.withSecond(1); // 修改时间对象秒钟为1
LocalDate localTime4 = now.withNano(1); // 修改时间对象纳秒为1
5)比较方法
LocalTime now = LocalTime.now();
LocalTime localTime = LocalTime.of(9, 9, 9);
int compare = localTime.compareTo(now); // localTime和当前时间比较--0(相等)正数(大)负数(小)
boolean after = localTime.isAfter(now); // localTime是否在当前时间之后
boolean before = localTime.isBefore(now); // localTime是否在当前时间之前
6)LocalTime 与 String之间的转换
/**
* String转LocalTime
* @param timeStr 日期的字符串
* @param pattern 格式示例: HH:mm:ss
* @return
*/
public static LocalTime toLocalTime(String timeStr, String pattern) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
return LocalTime.parse(timeStr, formatter);
}
/**
* LocalTime转String
* @param localTime localTime对象
* @param pattern 格式示例: HH:mm:ss
* @return
*/
public static LocalTime localTimeToStr(LocalTime localTime, String pattern) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
return localTime.format(formatter);
}
LocalTime是无法转换为Date的,因为它值包含了时间部分,而没有日期部分
2.3 LocalDateTime
1)创建方法
// 1.当前日期
LocalDateTime now1 = LocalDateTime.now();
// 2.当前日期 (指定时区)
LocalDateTime now2 = LocalDateTime.now(ZoneId.of("Asia/Shanghai"));
// 3.当前日期 (指定时钟)
LocalDateTime now3 = LocalDateTime.now(Clock.systemDefaultZone());
// 4.指定日期 2023-01-01 01:01:00
LocalDateTime localDateTime1 = LocalDateTime.of(2023, 1, 1, 1, 1);
// 4.使用LocalDate和LocalTime对象创建LocalDateTime对象
LocalDate localDate = LocalDate.now();
LocalTime localTime = LocalTime.now();
LocalDateTime localDateTime2 = LocalDateTime.of(localDate, localTime);
2)获取方法
LocalDateTime now = LocalDateTime.now();
int year = now.getYear(); // 获取年份
Month month = now.getMonth(); // 使用月份枚举值
int dayOfMonth = now.getDayOfMonth(); // 获取日期在该月是第几天
DayOfWeek dayOfWeek = now.getDayOfWeek(); // 获取日期是星期几
int dayOfYear = now.getDayOfYear(); // 获取日期在该年是第几天
int hour = now.getHour(); // 获取小时
int minute = now.getMinute(); // 获取分钟
int second = now.getSecond(); // 获取秒钟
int nano = now.getNano(); // 获取纳秒
3)运算方法
LocalDateTime now = LocalDateTime.now();
LocalDateTime localDateTime1 = now.plusDays(1); // 给当前时间加一天
LocalDateTime localDateTime2 = now.plusDays(1); // 给当前时间加一周
LocalDateTime localDateTime3 = now.plusMonths(1); // 给当前时间加一月
LocalDateTime localDateTime4 = now.plusYears(1); // 给当前时间加一年
LocalDateTime localDateTime5 = now.plusHours(1); // 给当前时间加一小时
LocalDateTime localDateTime6 = now.plusMinutes(1); // 给当前时间加一分钟
LocalDateTime localDateTime7 = now.plusSeconds(1); // 给当前时间加一秒
LocalDateTime localDateTime8 = now.plusNanos(1); // 给当前时间加一纳秒
LocalDateTime localDateTime9 = now.minusDays(1); // 给当前时间减一天
LocalDateTime localDateTime10 = now.minusWeeks(1); // 给当前时间减一周
LocalDateTime localDateTime11 = now.minusMonths(1); // 给当前时间减一月
LocalDateTime localDateTime12 = now.minusYears(1); // 给当前时间减一年
LocalDateTime localDateTime13 = now.minusHours(1); // 给当前时间减一小时
LocalDateTime localDateTime14 = now.minusMinutes(1); // 给当前时间减一分钟
LocalDateTime localDateTime15 = now.minusSeconds(1); // 给当前时间减一秒
LocalDateTime localDateTime16 = now.minusNanos(1); // 给当前时间减一纳秒
4)修改方法
LocalDateTime now = LocalDateTime.now();
LocalDateTime localDate1 = now.withYear(2020); // 修改日期对象年份为2020
LocalDateTime localDate2 = now.withMonth(1); // 修改日期对象月份为1
LocalDateTime localDate3 = now.withDayOfMonth(1); // 修改日期对象的日期(一月中的第几天)
LocalDateTime localDate4 = now.withDayOfYear(1); // 修改日期对象的日期(一年中的第几天)
LocalDateTime localTime1 = now.withHour(1); // 修改时间对象小时为1
LocalDateTime localTime2 = now.withMinute(1); // 修改时间对象分钟为1
LocalDateTime localTime3 = now.withSecond(1); // 修改时间对象秒钟为1
LocalDateTime localTime4 = now.withNano(1); // 修改时间对象纳秒为1
5)比较方法
LocalDateTime now = LocalDateTime.now();
LocalDateTime localDateTime = LocalDateTime.of(2023, 1, 1, 1, 1);
boolean isBefore = localDateTime.isBefore(now); // localDateTime是否在当天之前
boolean isAfter = localDateTime.isAfter(now); // localDateTime是否在当天之后
boolean isEqual = localDateTime.isEqual(now); // localDateTime是否在当天
6)从LocalDateTime获取LocalDate或者LocalTime
LocalDateTime localDateTime = LocalDateTime.now();
LocalDate localDate = localDateTime.toLocalDate(); // 从LocalDateTime获取LocalDate对象
LocalTime localTime = localDateTime.toLocalTime(); // 从LocalDateTime获取LocalTime对象
7)LocalDateTime与 String之间的转换
/**
* String转LocalDateTime
* @param dateTimeStr 日期的字符串
* @param pattern 格式示例: yyyy-MM-dd HH:mm:ss
* @return
*/
public static LocalDateTime toLocalDateTime(String dateTimeStr, String pattern) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
return LocalDateTime.parse(dateTimeStr, formatter);
}
/**
* LocalDateTime转String
* @param localDateTime 日期时间对象
* @param pattern 格式示例: yyyy-MM-dd HH:mm:ss
* @return
*/
public static String LocalDateTimetoStr(LocalDateTime localDateTime, String pattern) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
return localDateTime.format(formatter);
}
8)LocalDateTime与 Date之间的转换
/**
* Date转LocalDateTime
* @param date jdk6 日期对象
* @param zoneId 时区id
* @return
*/
public static LocalDateTime toLocalDateTime(Date date, ZoneId zoneId) {
// toInstant():将Date对象转换成为Instant(瞬时)对象
// ofInstant(): 将瞬时对象转换成为LocalDateTime对象
Instant instant = date.toInstant();
if (zoneId == null) {
zoneId = ZoneId.systemDefault();
}
return LocalDateTime.ofInstant(instant, zoneId);
}
/**
* LocalDateTime转Date
* @param localDateTime 日期时间对象
* @return
*/
public static Date LocalDateTimetoDate(LocalDateTime localDateTime, ZoneId zoneId) {
if (zoneId == null) {
zoneId = ZoneId.systemDefault();
}
ZonedDateTime zonedDateTime = localDateTime.atZone(zoneId);
Instant instant = zonedDateTime.toInstant();
return Date.from(instant);
}