dateutil 日期计算_日期时间 - 日期时间工具-DateUtil - 《Hutool 参考文档》 - 书栈网 · BookStack...

日期时间工具-DateUtil

由来

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

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

方法

转换

Date、long、Calendar之间的相互转换//当前时间

Datedate=DateUtil.date();

//当前时间

Datedate2=DateUtil.date(Calendar.getInstance());

//当前时间

Datedate3=DateUtil.date(System.currentTimeMillis());

//当前时间字符串，格式：yyyy-MM-dd HH:mm:ss

Stringnow=DateUtil.now();

//当前日期字符串，格式：yyyy-MM-dd

Stringtoday=DateUtil.today();

字符串转日期

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

yyyy-MM-dd HH:mm:ss

yyyy-MM-dd

HH:mm:ss

yyyy-MM-dd HH:mm

yyyy-MM-dd HH:mm:ss.SSS

StringdateStr="2017-03-01";

Datedate=DateUtil.parse(dateStr);

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

StringdateStr="2017-03-01";

Datedate=DateUtil.parse(dateStr,"yyyy-MM-dd");

格式化日期输出StringdateStr="2017-03-01";

Datedate=DateUtil.parse(dateStr);

//结果 2017/03/01

Stringformat=DateUtil.format(date,"yyyy/MM/dd");

//常用格式的格式化，结果：2017-03-01

StringformatDate=DateUtil.formatDate(date);

//结果：2017-03-01 00:00:00

StringformatDateTime=DateUtil.formatDateTime(date);

//结果：00:00:00

StringformatTime=DateUtil.formatTime(date);

获取Date对象的某个部分Datedate=DateUtil.date();

//获得年的部分

DateUtil.year(date);

//获得月份，从0开始计数

DateUtil.month(date);

//获得月份枚举

DateUtil.monthEnum(date);

//.....

开始和结束时间

有的时候我们需要获得每天的开始时间、结束时间，每月的开始和结束时间等等，DateUtil也提供了相关方法：

StringdateStr="2017-03-01 22:33:23";

Datedate=DateUtil.parse(dateStr);

//一天的开始，结果：2017-03-01 00:00:00

DatebeginOfDay=DateUtil.beginOfDay(date);

//一天的结束，结果：2017-03-01 23:59:59

DateendOfDay=DateUtil.endOfDay(date);

日期时间偏移

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

StringdateStr="2017-03-01 22:33:23";

Datedate=DateUtil.parse(dateStr);

//结果：2017-03-03 22:33:23

DatenewDate=DateUtil.offset(date,DateField.DAY_OF_MONTH,2);

//常用偏移，结果：2017-03-04 22:33:23

DateTimenewDate2=DateUtil.offsetDay(date,3);

//常用偏移，结果：2017-03-01 19:33:23

DateTimenewDate3=DateUtil.offsetHour(date,-3);

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

//昨天

DateUtil.yesterday()

//明天

DateUtil.tomorrow()

//上周

DateUtil.lastWeek()

//下周

DateUtil.nextWeek()

//上个月

DateUtil.lastMonth()

//下个月

DateUtil.nextMonth()

日期时间差

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

StringdateStr1="2017-03-01 22:33:23";

Datedate1=DateUtil.parse(dateStr1);

StringdateStr2="2017-04-01 23:33:23";

Datedate2=DateUtil.parse(dateStr2);

//相差一个月，31天

longbetweenDay=DateUtil.between(date1,date2,DateUnit.DAY);

格式化时间差

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

//Level.MINUTE表示精确到分

StringformatBetween=DateUtil.formatBetween(between,Level.MINUTE);

//输出：31天1小时

Console.log(formatBetween);

计时器

计时器用于计算某段代码或过程花费的时间

TimeIntervaltimer=DateUtil.timer();

//---------------------------------

//-------这是执行过程

//---------------------------------

timer.interval();//花费毫秒数

timer.intervalRestart();//返回花费时间，并重置开始时间

timer.intervalMinute();//花费分钟数

其它//年龄

DateUtil.ageOfNow("1990-01-30");

//是否闰年

DateUtil.isLeapYear(2017);