不灭的焱

革命尚未成功,同志仍须努力下载JDK17

作者:Albert.Wen  添加时间:2023-04-08 11:29:29  修改时间:2024-06-02 08:13:56  分类:08.Java基础  编辑

简介

在介绍Java8处理日期的方式之前,我们先聊一下Java8之前处理日期、日历和时间的不足之处:

  1. java.util.Date是可变类型;
  2. SimpleDateFormat是非线程安全的,应用会受一定的限制;

Java8时间类型的好处:

  1. 明确了日期、时间概念;例如:瞬间(instant)、 长短(duration)、日期、时间、时区和周期;
  2. 继承了Joda 库按人类语言和计算机各自解析的时间处理方式;
  3. 新API基于ISO标准日历系统,java.time包下的所有类都是不可变类型而且线程安全;

关键类:

  1. Instant:瞬间实例,即 时间戳
  2. LocalDate:本地日期,不包含具体时间 例如:2014-01-14 可以用来记录生日、纪念日、加盟日等。
  3. LocalTime:本地时间,不包含日期。
  4. LocalDateTime:组合了日期和时间,但不包含时差和时区信息。
  5. ZonedDateTime:最完整的日期时间,包含时区和相对UTC或格林威治的时差。
  6. ZoneOffSetZoneId 类,使得解决时区问题更为简便。
  7. DateTimeFormatter 类,解析、格式化时间也全部重新设计。

一、实战

1、LocalDate

1)获取当前日期

Java 8 中的 LocalDate 用于表示当天日期。和 java.util.Date不同,它只有日期,不包含时间。

//1)获取今天的日期
LocalDate today = LocalDate.now();
System.out.println("Today's local data : " + today);

//使用Date获取今天的日期
Date date = new Date();
System.out.println(date);

通过输出对比Date我们发现:Java8的LocalDate打印出的日期格式非常友好,不像 Date类 打印出一堆没有格式化的信息。

2)获取年、月、日信息

LocalDate 提供了获取年、月、日的快捷方法,其实例还包含很多其它的日期属性。通过调用这些方法就可以很方便的得到需要的日期信息,不用像以前一样需要依赖java.util.Calendar类了。

//2)获取年、月、日信息
int year = today.getYear();
int month = today.getMonthValue();
int day = today.getDayOfMonth();
System.out.printf("Year: %d, Month: %d, Day: %d。 %n ", year, month, day);

3)创建特定的日期

  • 我们可以调用工厂方法 LocalDate.of() 创建任意日期, 该方法需要传入年、月、日做参数,返回对应的LocalDate实例。

好处:

这个方法没再犯老API的设计错误,比如年度起始于1900,月份是从 0 开始等等。日期所见即所得,就像下面这个例子表示了6月26日,直接明了。

//3)创建特定日期
LocalDate dateOfBirth = LocalDate.of(2019, 06, 26);
System.out.println("The special date is: " + dateOfBirth);

4)判断两个日期是否相等

在项目开发过程中,经常会遇到这个需求。好在,LocalDate重载了equal方法。

注:如果比较的日期是字符型的,需要先解析成日期对象再作判断。

//4)判断两个日期是否相等
 boolean equal = today.equals(dateOfBirth);
 System.out.println("是今天? " + equal);

5)检查像生日这种周期性事件

Java 中另一个日期时间的处理就是检查类似生日、纪念日、法定假日(国庆以及春节)、或者每个月固定时间发送邮件给客户 这些周期性事件。

MonthDay类组合了月份和日,我们可以用它判断每年都会发生的事件。

还有一个类似的YearMonth类,这个类也都是不可变并且线程安全的值类型。

//5)检查像生日这种周期性事件
LocalDate dateOfBirth = LocalDate.of(2019, 06, 26);
MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());
MonthDay currentMonthDay = MonthDay.now();
boolean happen = currentMonthDay.equals(birthday);
System.out.println("生日到了? " + happen);

6)处理固定日期

MonthDay 检查重复事件的例子相似,YearMonth 是另一个组合类,用于表示信用卡到期日、FD到期日、期货期权到期日等。还可以用这个类得到 当月共有多少天,YearMonth 实例的 lengthOfMonth() 方法可以返回当月的天数,在判断2月有28天还是29天时非常有用。

// YearMonth 固定日期,lengthOfMonth用来获取一月有几天
YearMonth currentYearMonth = YearMonth.now();
System.out.printf("%s have %d days. %n", currentYearMonth, currentYearMonth.lengthOfMonth());

7)计算一个星期之后的日期

LocalDate日期不包含时间信息,它的plus()方法用来增加天、周、月;ChronoUnit类声明了这些时间单位。

注意:由于LocalDate也是不变类型,返回后一定要用变量赋值。

//8)计算一周后的日期,LocalDate的plus方法增加天数、周数或者月数。
LocalDate today = LocalDate.now();
LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
System.out.println("Today is: " + today);
System.out.println("Date after 1 week: " + nextWeek);

可以用同样的方法增加1个月、1年、1小时、1分钟甚至一个世纪,更多选项可以查看Java 8 API中的ChronoUnit类。

8)获取一年之前的日期

我们利用 minus() 方法计算一年前的日期。

//9)计算一年前的日期
LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);
System.out.println("Date before 1 year: " + previousYear);

9)判断日期是早于还是晚于另一个日期

LocalDate 类有两类方法 isBefore()isAfter() 用于比较日期。调用 isBefore() 方法时,如果给定日期小于当前日期则返回 true。

LocalDate today = LocalDate.now();
LocalDate tomorrow = today.plus(1, ChronoUnit.DAYS);
if (tomorrow.isAfter(today)) {
    System.out.println("Tomorrow comes after today!");
}

10)检查闰年

LocalDate类有一个很实用的方法 isLeapYear() 判断该实例是否是一个闰年。

LocalDate today = LocalDate.now();
boolean isLeapYear = today.isLeapYear();
System.out.println("今年是闰年吗?" + isLeapYear);

11)计算两个日期之间的天数和月数

Java 8中可以用java.time.Period类用来计算两个日期之间的天数、周数或月数。

LocalDate today = LocalDate.now();
LocalDate java8time = LocalDate.of(2019, Month.AUGUST, 31);
Period period = Period.between(java8time, today);
System.out.printf("从2019年8月31到现在过去了 %d 个月。\n", period.getMonths());

卧槽,什么情况,从2019年8月31到现在(2021-09-30)过去了 0 个月。

我们debug看一下:原来period参数中的组成是年、月、日

我们将获取到的相差的年数 * 12 再加上月数就好了撒。

int periodMonth = period.getYears() * 12 + period.getMonths();
System.out.printf("修正版:从2019年8月31到现在过去了 %d 个月。\n", periodMonth);

2、LocalTime类

1)获取当前时间

使用 LocalTime 类获取时间,和只能获取到日期的LocalDate类似。通过调用静态工厂方法now()可以获取当前时间,默认时间格式化为:hh:mm:ss:nnn

2)在现有的时间上增加小时

Java 8 提供了更好的 plusHours() 方法替换 add() ,并且是兼容的。

注:这些方法返回一个全新的LocalTime实例,由于其不可变性,返回后一定要用变量赋值。

//7)在现有的时间上增加小时
LocalTime time = LocalTime.now();
LocalTime newTime = time.plusHours(2);
System.out.println("Time after 2 hours: " + newTime);

3、LocalDateTime类

1)包含时差信息的日期和时间

ZoneOffset类用来表示时区,举例来说印度与GMT或UTC标准时区相差+05:30,可以通过ZoneOffset.of()静态方法来 获取对应的时区。一旦得到了时差就可以通过传入LocalDateTimeZoneOffset来创建一个OffSetDateTime对象

LocalDateTime dateTime = LocalDateTime.of(2020, Month.JANUARY, 10, 11, 11);
//时差加上5个半小时
ZoneOffset offset = ZoneOffset.of("+05:30");
OffsetDateTime offsetDateTime = OffsetDateTime.of(dateTime, offset);
System.out.println("2020-1-10 11:11 加上5个半小时时差后的北京时间为:" + offsetDateTime);

4、ZoneDateTime类

1)处理时区

处理时区Java 8不仅分离了日期和时间,也把时区分离出来了。现在有一系列单独的类如 ZoneId 来处理特定时区,ZoneDateTime 类来表示某时区下的时间。

//使用ZoneId处理特定的时区
ZoneId america = ZoneId.of("America/New_York");
LocalDateTime localDateTime = LocalDateTime.now();
ZonedDateTime zonedDateTimeInNewYork = ZonedDateTime.of(localDateTime, america);
System.out.println("现在的日期和时间再特定的时区是:" + zonedDateTimeInNewYork);

5、Clock类

Java 8增加了一个 Clock 时钟类用于获取当时的瞬间,或当前时区下的日期时间信息。以前用到System.currentTimeInMillis()TimeZone.getDefault() 的地方都可用Clock替换。

//10)Java8的Clock时钟类
//根据系统时间返回当前时间并设置为UTC
Clock clock = Clock.systemUTC();
System.out.println("Clock: " + clock);

6、Instant类

1)获取当前的瞬间

Instant类有一个静态工厂方法now()会返回当前的瞬间。

Instant timestamp = Instant.now();
System.out.println("What is value of this instant:" + timestamp);

7、DateTimeFormatter类

1)使用预定义的格式化工具去解析或格式化日期

Java 8引入了全新的日期时间格式工具,线程安全而且使用方便。它自带了一些常用的内置格式化工具。

下面这个例子使用了BASIC_ISO_DATE格式化工具将20200628格式化成2020年6月28日。

String dayAfterTomorrow = "20200628";
LocalDate formatted = LocalDate.parse(dayAfterTomorrow, DateTimeFormatter.BASIC_ISO_DATE);
System.out.printf("Date generated from String %s is %s. %n", dayAfterTomorrow, formatted);

二、全量代码:

package com.saint.base.localdate;

import java.time.*;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoUnit;
import java.util.Date;

/**
 * @author Saint
 */
public class CurrentDate {
    public static void main(String[] args) {
        //1)获取今天的日期
        LocalDate today = LocalDate.now();
        System.out.println("Today's local data : " + today);
        //使用Date获取今天的日期
        Date date = new Date();
        System.out.println(date);

        //2)获取年、月、日信息
        int year = today.getYear();
        int month = today.getMonthValue();
        int day = today.getDayOfMonth();
        System.out.printf("Year: %d, Month: %d, Day: %d。 %n ", year, month, day);

        //3)创建特定日期
        LocalDate dateOfBirth = LocalDate.of(2019, 06, 26);
        System.out.println("The special date is: " + dateOfBirth);

        //4)判断两个日期是否相等
        boolean equal = today.equals(dateOfBirth);
        System.out.println("是今天? " + equal);

        //5)检查像生日这种周期性事件
        MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());
        MonthDay currentMonthDay = MonthDay.now();
        boolean happen = currentMonthDay.equals(birthday);
        System.out.println("生日到了? " + happen);

        //6)获取当前时间
        LocalTime time = LocalTime.now();
        System.out.println("Local time now: " + time);

        //7)在现有的时间上增加小时
        LocalTime newTime = time.plusHours(2);
        System.out.println("Time after 2 hours: " + newTime);

        //8)计算一周后的日期,LocalDate的plus方法增加天数、周数或者月数。
        LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
        System.out.println("Today is: " + today);
        System.out.println("Date after 1 week: " + nextWeek);

        //9)计算一年前的日期
        LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);
        System.out.println("Date before 1 year: " + previousYear);

        //10)Java8的Clock时钟类
        //根据系统时间返回当前时间并设置为UTC
        Clock clock = Clock.systemUTC();
        System.out.println("Clock: " + clock);

        //11)判断日期是早于还是晚于另一个日期
        LocalDate tomorrow = today.plus(1, ChronoUnit.DAYS);
        if (tomorrow.isAfter(today)) {
            System.out.println("Tomorrow comes after today!");
        }

        //12)处理时区,Java8不仅分离了日期和时间,也把时区分离出来了。
        //使用ZoneId处理特定的时区
        ZoneId america = ZoneId.of("America/New_York");
        LocalDateTime localDateTime = LocalDateTime.now();
        ZonedDateTime zonedDateTimeInNewYork = ZonedDateTime.of(localDateTime, america);
        System.out.println("现在的日期和时间再特定的时区是:" + zonedDateTimeInNewYork);

        //13)YearMonth 固定日期,lengthOfMonth用来获取一月有几天
        YearMonth currentYearMonth = YearMonth.now();
        System.out.printf("%s have %d days. %n", currentYearMonth, currentYearMonth.lengthOfMonth());

        //14)检查闰年
        boolean isLeapYear = today.isLeapYear();
        System.out.println("今年是闰年吗?" + isLeapYear);

        //15)计算两个日期之间的天数和月数
        LocalDate java8time = LocalDate.of(2019, Month.AUGUST, 31);
        Period period = Period.between(java8time, today);
        System.out.printf("从2019年8月31到现在过去了 %d 个月。\n", period.getMonths());
        int periodMonth = period.getYears() * 12 + period.getMonths();
        System.out.printf("修正版:从2019年8月31到现在过去了 %d 个月。\n", periodMonth);

        //16)包含时差信息的日期和时间
        LocalDateTime dateTime = LocalDateTime.of(2020, Month.JANUARY, 10, 11, 11);
        //时差加上5个半小时
        ZoneOffset offset = ZoneOffset.of("+05:30");
        OffsetDateTime offsetDateTime = OffsetDateTime.of(dateTime, offset);
        System.out.println("2020-1-10 11:11 加上5个半小时时差后的北京时间为:" + offsetDateTime);

        //17)获取当前的瞬间
        Instant timestamp = Instant.now();
        System.out.println("What is value of this instant:" + timestamp);

        //18)使用预定义的格式化工具去解析或格式化日期
        String dayAfterTomorrow = "20200628";
        LocalDate formatted = LocalDate.parse(dayAfterTomorrow, DateTimeFormatter.BASIC_ISO_DATE);
        System.out.printf("Date generated from String %s is %s. %n", dayAfterTomorrow, formatted);

    }
}

控制台输出:

三、总结:

Java8日期时间API的重点:

  • 提供了javax.time.ZoneId获取时区。
  • 提供了LocalDate和LocalTime类。
  • Java8 的所有日期和时间API都是不可变类并且是线程安全的,而现有的Date和Calendar API中的java.util.Date和SimpleDateFormat非线程安全的。
  • java.time的子包java.time.format用于格式化, java.time.temporal用于更底层的操作。
  • 时区代表了地球上某个区域内普遍使用的标准时间。每个时区都有一个代号。
    格式通常由区域/城市构成(Asia/Tokyo),再加上与格林威治或UTC的时差。例如:东京的时差是+09:00。

四、Local日期时间相关工具类

package com.saint.base.util;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.time.*;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoUnit;
import java.util.Date;

/**
 * 本地日期和时间格式化工具
 *
 * @author Saint
 * @version 1.0
 * @createTime 2021-01-08 7:00
 */
public class LocalDateUtil {
    private static final Logger LOGGER = LoggerFactory.getLogger(LocalDateUtil.class);

    /**
     * String类型转LocalDateTime类型
     *
     * @param date    日期字符串
     * @param pattern 日期格式
     * @return LocalDateTime类型
     */
    public static LocalDateTime stringToLocalDateTime(String date, String pattern) {
        if (pattern == null || "".equals(pattern)) {
            return LocalDateTime.of(1900, 1, 1, 0, 0, 0);
        }
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return LocalDateTime.parse(date, formatter);
    }

    /**
     * String类型转LocalDate类型
     *
     * @param date    日期字符串
     * @param pattern 日期格式
     * @return LocalDate类型
     */
    public static LocalDate stringToLocalDate(String date, String pattern) {
        if (pattern == null || "".equals(pattern)) {
            return LocalDate.of(1900, 1, 1);
        }
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return LocalDate.parse(date, formatter);
    }

    /**
     * String类型转LocalTime类型
     *
     * @param date    时间字符串
     * @param pattern 时间格式
     * @return LocalTime类型
     */
    public static LocalTime stringToLocalTime(String date, String pattern) {
        if (pattern == null || "".equals(pattern)) {
            return LocalTime.of(0, 0, 0);
        }
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return LocalTime.parse(date, formatter);
    }

    /**
     * LocalDateTime类型转String类型
     *
     * @param localDateTime localDateTime类型日期
     * @param pattern       字符串格式
     * @return String类型
     */
    public static String localDateTimeToString(LocalDateTime localDateTime, String pattern) {
        if (pattern == null || "".equals(pattern)) {
            return "1900-01-01T00:00:00.000";
        }
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return localDateTime.format(formatter);
    }

    /**
     * LocalDate类型转String类型
     *
     * @param localDate localDate类型日期
     * @param pattern   字符串格式
     * @return String类型
     */
    public static String localDateToString(LocalDate localDate, String pattern) {
        if (pattern == null || "".equals(pattern)) {
            return "1900-01-01";
        }
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return localDate.format(formatter);
    }

    /**
     * Date类型转LocalDateTime类型
     *
     * @param date Date类型日期
     * @return LocalDateTime类型
     */
    public static LocalDateTime dateToLocalDateTime(Date date) {
        if (date == null) {
            return LocalDateTime.of(1900, 1, 1, 0, 0, 0);
        }
        Instant instant = date.toInstant();
        // 获取本地时区
        ZoneId zoneId = ZoneId.systemDefault();
        return LocalDateTime.ofInstant(instant, zoneId);
    }

    /**
     * Date类型转LocalDate类型
     *
     * @param date Date类型日期
     * @return LocalDate类型
     */
    public static LocalDate dateToLocalDate(Date date) {
        if (date == null) {
            return LocalDate.of(1900, 1, 1);
        }
        LocalDateTime localDateTime = dateToLocalDateTime(date);
        return localDateTime.toLocalDate();
    }

    /**
     * Date类型转LocalTime类型
     *
     * @param date Date类型日期
     * @return LocalTime类型
     */
    public static LocalTime dateToLocalTime(Date date) {
        if (date == null) {
            return LocalTime.of(0, 0, 0);
        }
        LocalDateTime localDateTime = dateToLocalDateTime(date);
        return localDateTime.toLocalTime();
    }

    /**
     * LocalDateTime类型转Date类型
     *
     * @param localDateTime LocalDateTime类型时间
     * @return Date类型
     */
    public static Date localDateTimeToDate(LocalDateTime localDateTime) {
        if (localDateTime == null) {
            localDateTime = LocalDateTime.of(1900, 1, 1, 0, 0, 0);
        }
        ZoneId zoneId = ZoneId.systemDefault();
        Instant instant = localDateTime.atZone(zoneId).toInstant();
        return Date.from(instant);
    }

    /**
     * LocalDate类型转Date类型
     *
     * @param localDate LocalDate类型日期
     * @return Date类型
     */
    public static Date localDateToDate(LocalDate localDate) {
        if (localDate == null) {
            localDate = LocalDate.of(1900, 1, 1);
        }
        ZoneId zoneId = ZoneId.systemDefault();
        Instant instant = localDate.atStartOfDay().atZone(zoneId).toInstant();
        return Date.from(instant);
    }

    /**
     * LocalTime类型 + LocalDate类型 转Date类型
     *
     * @param localDate LocalDate类型日期
     * @param localTime LocalTime类型时间
     * @return Date类型
     */
    public static Date localTimeToDate(LocalDate localDate, LocalTime localTime) {
        if (localTime == null) {
            return localDateToDate(localDate);
        }
        LocalDateTime localDateTime = LocalDateTime.of(localDate, localTime);
        return localDateTimeToDate(localDateTime);
    }

    public static LocalDateTime addMonth(LocalDateTime time, int interval) {
        return time.plus(interval, ChronoUnit.MONTHS);
    }

    public static LocalDateTime addDay(LocalDateTime time, int interval) {
        return time.plus(interval, ChronoUnit.DAYS);
    }

    public static LocalDateTime addHour(LocalDateTime time, int interval) {
        return time.plus(interval, ChronoUnit.HOURS);
    }

    public static LocalDateTime addMinute(LocalDateTime time, int interval) {
        return time.plus(interval, ChronoUnit.MINUTES);
    }

    public static LocalDateTime addSecond(LocalDateTime time, int interval) {
        return time.plus(interval, ChronoUnit.SECONDS);
    }

    /**
     * 获取两个时间的时间间隔,time2-time1
     *
     * @param time1
     * @param time2
     */
    public static long getIntervalMillisecond(LocalDateTime time1, LocalDateTime time2) {
        return Duration.between(time1, time2).toMillis();
    }

}

 

 

摘自:https://blog.csdn.net/Saintmm/article/details/120566578