Hutool 日期时间工具-DateUtil使用（格式化输出，字符串转日期，时间差，格式化时间差，Long、Date相互转化，星期几，时间偏移，获取时间指定部分，开始结束时间）

考虑到Java本身对日期时间的支持有限，并且Date和Calendar对象的并存导致各种方法使用混乱和复杂，故使用此工具类做了封装。这其中的封装主要是日期和字符串之间的转换，以及提供对日期的定位（一个月前等等）。

对于Date对象，为了便捷，使用了一个DateTime类来代替之，继承自Date对象，主要的便利在于，覆盖了toString()方法，返回yyyy-MM-dd HH:mm:ss形式的字符串，方便在输出时的调用（例如日志记录等），提供了众多便捷的方法对日期对象操作。

1 格式化输出

String dateStr = "2021-04-21 01:02:03";
Date date = DateUtil.parse(dateStr);

//结果 2021/04/21
String format = DateUtil.format(date, "yyyy/MM/dd");

//常用格式的格式化，结果：2021-04-21
String formatDate = DateUtil.formatDate(date);

//结果：2021-04-01 01:02:03
String formatDateTime = DateUtil.formatDateTime(date);

//结果：01:02:03
String formatTime = DateUtil.formatTime(date);

2 字符串转日期

DateUtil.parse方法会自动识别一些常用格式，包括：

（1）yyyy-MM-dd HH:mm:ss

（2）yyyy-MM-dd

（3）HH:mm:ss

（4）yyyy-MM-dd HH:mm

（5）yyyy-MM-dd HH:mm:ss.SSS

String dateStr = "2021-04-21";
Date date = DateUtil.parse(dateStr);

我们也可以使用自定义日期格式转化：

String dateStr = "2021-04-21";
Date date = DateUtil.parse(dateStr, "yyyy-MM-dd");

3 日期时间差

有时候我们需要计算两个日期之间的时间差（相差天数、相差小时数等等），Hutool将此类方法封装为between方法：

Date startDate=DateUtil.parse("2021-04-20 02:00:00");
Date endDate=DateUtil.parse("2021-04-21 05:10:00");
//相差周数
long week=DateUtil.between(startDate,endDate,DateUnit.WEEK);
//相差天数
long day=DateUtil.between(startDate,endDate,DateUnit.DAY);
//相差小时数
long hour=DateUtil.between(startDate,endDate,DateUnit.HOUR);
//相差分钟数
long minute=DateUtil.between(startDate,endDate,DateUnit.MINUTE);
//相差秒数
long second=DateUtil.between(startDate,endDate,DateUnit.SECOND);
//相差毫秒数
long millis=DateUtil.between(startDate,endDate,DateUnit.MS);

4 格式化时间差

有时候我们希望看到易读的时间差，比如XX天XX小时XX分XX秒，此时使用DateUtil.formatBetween方法：

Date startDate=DateUtil.parse("2021-04-20 02:00:00");
Date endDate=DateUtil.parse("2021-04-21 05:10:00");

//相差毫秒数
long millis=DateUtil.between(startDate,endDate,DateUnit.MS);
//相差1天(天)
String formatDay = DateUtil.formatBetween(millis, BetweenFormatter.Level.DAY);
//相差1天3小时(小时)
String formatHour = DateUtil.formatBetween(millis, BetweenFormatter.Level.HOUR);
//相差1天3小时10分(分钟)
String formatMinute = DateUtil.formatBetween(millis, BetweenFormatter.Level.MINUTE);
//相差1天3小时10分(秒)
String formatSecond = DateUtil.formatBetween(millis, BetweenFormatter.Level.SECOND);
//相差1天3小时10分(毫秒)
String formatMillis = DateUtil.formatBetween(millis, BetweenFormatter.Level.MILLISECOND);

注：

formatBetween(long betweenMs, Level level) 的第一个参数betweenMs为相差毫秒数。

5 Long、Date相互转化

5.1 Date转Long

Long date = DateUtil.parse("2021-05-06", "yyyy-MM-dd").getTime();

5.2 Long转Date

Long longDate=DateUtil.parse("2021-05-06", "yyyy-MM-dd").getTime();
Date date = DateUtil.date(longDate);

6 星期几

    /**
     * 返回星期几
     * @param date
     * @return
     */
    public static String dayOfWeek(Date date){
            int day= DateUtil.dayOfWeek(date);
            switch (day){
                case 1:return "星期天";
                case 2:return "星期一";
                case 3:return "星期二";
                case 4:return "星期三";
                case 5:return "星期四";
                case 6:return "星期五";
                case 7:return "星期六";
                default:return "";
            }
    }

7 日期时间偏移

日期或时间的偏移指针对某个日期增加或减少分、小时、天等等，达到日期变更的目的。Hutool也针对其做了大量封装。

String dateStr = "2021-05-25 22:33:23";
Date date = DateUtil.parse(dateStr);

//减3天
DateUtil.offsetDay(date, -3);
DateUtil.offset(date, DateField.DAY_OF_YEAR, -3);

针对当前时间，提供了简化的偏移方法（例如昨天、上周、上个月等）：

//昨天
DateUtil.yesterday()
//明天
DateUtil.tomorrow()
//上周
DateUtil.lastWeek()
//下周
DateUtil.nextWeek()
//上个月
DateUtil.lastMonth()
//下个月
DateUtil.nextMonth()

想要了解更多的日期时间偏移方法请查看以下博客。

Java 实现日期时间偏移2种实现方法（Hutool、Apache Commons）

8 获取日期时间指定部分

        Date date = DateUtil.parse("2021-06-30 11:22:33.100");
        //年
        int year = DateUtil.year(date);//2021
        //年和季度
        String yearAndQuarter = DateUtil.yearAndQuarter(date);//20212
        //季度
        int quarter = DateUtil.quarter(date);//2
        //月,从0开始
        int month = DateUtil.month(date);//5 六月
        //获得指定日期是所在年份的第几周
        // 此方法返回值与一周的第一天有关，比如： 2016年1月3日为周日，如果一周的第一天为周日，那这天是第二周（返回2）
        // 如果一周的第一天为周一，那这天是第一周（返回1） 跨年的那个星期得到的结果总是1
        //一周的第一天为周一
        int weekOfYear = DateUtil.weekOfYear(date);//27
        //一月的第几周,一周的第一天为周一
        int weekOfMonth = DateUtil.weekOfMonth(date);//5
        //一周的第几天,从星期天开始，从1开始
        int dayOfWeek = DateUtil.dayOfWeek(date);//4 星期三
        //一月的第几天
        int dayOfMonth = DateUtil.dayOfMonth(date);//30
        //一年的第几天
        int dayOfYear = DateUtil.dayOfYear(date);//181
        //小时
        int hour = DateUtil.hour(date, true);//11
        //分钟
        int minute = DateUtil.minute(date);//22
        //秒
        int second = DateUtil.second(date);//33
        //毫秒
        int millisecond = DateUtil.millisecond(date);//100

9 开始时间和结束时间

        Date date = DateUtil.parse("2021-06-30 11:22:33.100");
        //当前秒的开始时间
        Date beginOfSecond = DateUtil.beginOfSecond(date);//2021-06-30 11:22:33.000
        //当前秒的结束时间
        Date endOfSecond = DateUtil.endOfSecond(date);//2021-06-30 11:22:33.999
        //当前分钟的开始时间
        Date beginOfMinute = DateUtil.beginOfMinute(date);//2021-06-30 11:22:00
        //当前分钟的结束时间
        Date endOfMinute = DateUtil.endOfMinute(date);//2021-06-30 11:22:59
        //当前小时的开始时间
        Date beginOfHour = DateUtil.beginOfHour(date);//2021-06-30 11:00:00
        //当前小时的结束时间
        Date endOfHour = DateUtil.endOfHour(date);//2021-06-30 11:59:59
        //当前天的开始时间
        Date beginOfDay = DateUtil.beginOfDay(date);//2021-06-30 00:00:00
        //当前天的结束时间
        Date endOfDay = DateUtil.endOfDay(date);//2021-06-30 23:59:59
        //当前周的开始时间,
        Date beginOfWeek = DateUtil.beginOfWeek(date);//2021-06-28 00:00:00 周一
        //当前周的结束时间
        Date endOfWeek = DateUtil.endOfWeek(date);//2021-07-04 23:59:59
        //当前月的开始时间
        Date beginOfMonth = DateUtil.beginOfMonth(date);//2021-06-01 00:00:00
        //当前月的结束时间
        Date endOfMonth = DateUtil.endOfMonth(date);//2021-06-30 23:59:59
        //当前季度的开始时间
        Date beginOfQuarter = DateUtil.beginOfQuarter(date);//2021-04-01 00:00:00
        //当前季度的结束时间
        Date endOfQuarter = DateUtil.endOfQuarter(date);//2021-06-30 23:59:59
        //当前年的开始时间
        Date beginOfYear = DateUtil.beginOfYear(date);//2021-01-01 00:00:00
        //当前年的结束时间
        Date endOfYear = DateUtil.endOfYear(date);//2021-12-31 23:59:59

旭东怪的个人空间_哔哩哔哩_Bilibili旭东怪，人生低谷不可怕，可怕的是坚持不到人生转折点的那一天;旭东怪的主页、动态、视频、专栏、频道、收藏、订阅等。哔哩哔哩Bilibili，你感兴趣的视频都在B站。https://space.bilibili.com/484264966?spm_id_from=333.1007.0.0