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

逃离我推掉我的手 2023-01-15 02:25 453阅读 0赞

考虑到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）][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

[Java _2_Hutool_Apache Commons]: https://blog.csdn.net/qq_38974638/article/details/117264363