[Hutool] 日期时间工具-DateUtil使用

格式化日期输出

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

字符串转日期

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");

日期时间差

有时候需要计算两个日期之间的时间差（相差天数、相差小时数等等），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);

格式化时间差

有时候希望看到易读的时间差，比如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为相差毫秒数。

Long与Date相互转化

Date转Long

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

Long转Date

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

星期转换

    /**
     * 返回星期几
     * @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 "";
            }
    }

日期时间偏移

日期或时间的偏移指针对某个日期增加或减少分、小时、天等等，达到日期变更的目的。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()

获取日期时间指定部分

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

开始时间和结束时间

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