首页  思维导图  详情

01HuTool-日期时间V1.0.1

2021-08-17 17:29:34   0  举报





AI智能生成

HuTool时间日期工具类

HuTool

HuTool工具

高效工作方式

移动开发

作者其他创作

大纲/内容

日期时间

概述

日期时间工具

DateUtil 针对日期时间操作提供一系列静态方法

DateTime 提供类似于Joda-Time中日期时间对象的封装，继承自Date类，并提供更加丰富的对象方法。

FastDateFormat 提供线程安全的针对Date对象的格式化和日期字符串解析支持。此对象在实际使用中并不需要感知，相关操作已经封装在DateUtil和DateTime的相关方法中。

DateBetween 计算两个时间间隔的类，除了通过构造新对象使用外，相关操作也已封装在DateUtil和DateTime的相关方法中。

TimeInterval 一个简单的计时器类，常用于计算某段代码的执行时间，提供包括毫秒、秒、分、时、天、周等各种单位的花费时长计算，对象的静态构造已封装在DateUtil中。

DatePattern 提供常用的日期格式化模式，包括String类型和FastDateFormat两种类型。

日期枚举

说明：考虑到Calendar类中表示时间的字段（field）都是使用int表示，在使用中非常不便，因此针对这些int字段，封装了与之对应的Enum枚举类，这些枚举类在DateUtil和DateTime相关方法中做为参数使用，可以更大限度的缩小参数限定范围。 这些定义的枚举值可以通过getValue()方法获得其与Calendar类对应的int值，通过of(int)方法从Calendar中int值转为枚举对象。

Month 表示月份，与Calendar中的int值一一对应。

Week 表示周，与Calendar中的int值一一对应

月份枚举

说明：通过月份枚举可以获得某个月的最后一天

int lastDay = Month.of(Calendar.JANUARY).getLastDay(false); 另外，Hutool还定义了季度枚举。Season.SPRING为第一季度，表示1~3月。季度的概念并不等同于季节，因为季节与月份并不对应，季度常用于统计概念

时间枚举

说明：时间枚举DateUnit主要表示某个时间单位对应的毫秒数，常用于计算时间差。 例如：DateUnit.MINUTE表示分，也表示一分钟的毫米数，可以通过调用其getMillis()方法获得其毫秒数。

日期时间工具-DateUtil

由来

考虑到Java本身对日期时间的支持有限，并且Date和Calendar对象的并存导致各种方法使用混乱和复杂，故使用此工具类做了封装。这其中的封装主要是日期和字符串之间的转换，以及提供对日期的定位（一个月前等等）。 对于Date对象，为了便捷，使用了一个DateTime类来代替之，继承自Date对象，主要的便利在于，覆盖了toString()方法，返回yyyy-MM-dd HH:mm:ss形式的字符串，方便在输出时的调用（例如日志记录等），提供了众多便捷的方法对日期对象操作。

方法

转换

Date、long、Calendar之间的相互转换

//当前时间 Date date = DateUtil.date(); //当前时间 Date date2 = DateUtil.date(Calendar.getInstance()); //当前时间 Date date3 = DateUtil.date(System.currentTimeMillis()); //当前时间字符串，格式：yyyy-MM-dd HH:mm:ss String now = DateUtil.now(); //当前日期字符串，格式：yyyy-MM-dd String today= DateUtil.today();

字符串转日期

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

yyyy/MM/dd HH:mm:ss     yyyy.MM.dd HH:mm:ss     yyyy年MM月dd日 HH时mm分ss秒     yyyy-MM-dd     yyyy/MM/dd     yyyy.MM.dd     HH:mm:ss     HH时mm分ss秒     yyyy-MM-dd HH:mm     yyyy-MM-dd HH:mm:ss.SSS     yyyyMMddHHmmss     yyyyMMddHHmmssSSS     yyyyMMdd     EEE, dd MMM yyyy HH:mm:ss z     EEE MMM dd HH:mm:ss zzz yyyy     yyyy-MM-dd'T'HH:mm:ss'Z'     yyyy-MM-dd'T'HH:mm:ss.SSS'Z'     yyyy-MM-dd'T'HH:mm:ssZ     yyyy-MM-dd'T'HH:mm:ss.SSSZ

举例： String dateStr = "2017-03-01"; Date date = DateUtil.parse(dateStr); String dateStr = "2017-03-01"; Date date = DateUtil.parse(dateStr, "yyyy-MM-dd");

格式化日期输出

String dateStr = "2017-03-01"; Date date = DateUtil.parse(dateStr); //结果 2017/03/01 String format = DateUtil.format(date, "yyyy/MM/dd"); //常用格式的格式化，结果：2017-03-01 String formatDate = DateUtil.formatDate(date); //结果：2017-03-01 00:00:00 String formatDateTime = DateUtil.formatDateTime(date); //结果：00:00:00 String formatTime = DateUtil.formatTime(date);

获取Date对象的某个部分

Date date = DateUtil.date(); //获得年的部分 DateUtil.year(date); //获得月份，从0开始计数 DateUtil.month(date); //获得月份枚举 DateUtil.monthEnum(date); //.....

开始和结束时间

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

String dateStr = "2017-03-01 22:33:23"; Date date = DateUtil.parse(dateStr); //一天的开始，结果：2017-03-01 00:00:00 Date beginOfDay = DateUtil.beginOfDay(date); //一天的结束，结果：2017-03-01 23:59:59 Date endOfDay = DateUtil.endOfDay(date);

日期时间偏移

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

String dateStr = "2017-03-01 22:33:23"; Date date = DateUtil.parse(dateStr); //结果：2017-03-03 22:33:23 Date newDate = DateUtil.offset(date, DateField.DAY_OF_MONTH, 2); //常用偏移，结果：2017-03-04 22:33:23 DateTime newDate2 = DateUtil.offsetDay(date, 3); //常用偏移，结果：2017-03-01 19:33:23 DateTime newDate3 = DateUtil.offsetHour(date, -3);

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

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

日期时间差

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

String dateStr1 = "2017-03-01 22:33:23"; Date date1 = DateUtil.parse(dateStr1); String dateStr2 = "2017-04-01 23:33:23"; Date date2 = DateUtil.parse(dateStr2); //相差一个月，31天 long betweenDay = DateUtil.between(date1, date2, DateUnit.DAY);

格式化时间差

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

//Level.MINUTE表示精确到分 String formatBetween = DateUtil.formatBetween(between, Level.MINUTE); //输出：31天1小时 Console.log(formatBetween);

星座和属相

// "摩羯座" String zodiac = DateUtil.getZodiac(Month.JANUARY.getValue(), 19); // "狗" String chineseZodiac = DateUtil.getChineseZodiac(1994);

其他

//年龄 DateUtil.ageOfNow("1990-01-30"); //是否闰年 DateUtil.isLeapYear(2017);

日期时间对象-DateTime

由来

考虑工具类的局限性，在某些情况下使用并不简便，于是DateTime类诞生。DateTime对象充分吸取Joda-Time库的优点，并提供更多的便捷方法，这样我们在开发时不必再单独导入Joda-Time库便可以享受简单快速的日期时间处理过程。 DateTime类继承于java.util.Date类，为Date类扩展了众多简便方法，这些方法多是DateUtil静态方法的对象表现形式，使用DateTime对象可以完全替代开发中Date对象的使用。

使用方法

DateTime对象包含众多的构造方法，构造方法支持的参数有： 构建对象有两种方式：DateTime.of()和new DateTime()：

Date     Calendar     String(日期字符串，第二个参数是日期格式)     long 毫秒数

Date date = new Date();          //new方式创建 DateTime time = new DateTime(date); Console.log(time); //of方式创建 DateTime now = DateTime.now(); DateTime dt = DateTime.of(date);

使用对象

DateTime的成员方法与DateUtil中的静态方法所对应，因为是成员方法，因此可以使用更少的参数操作日期时间。

DateTime dateTime = new DateTime("2017-01-05 12:34:23", DatePattern.NORM_DATETIME_FORMAT);          //年，结果：2017 int year = dateTime.year(); //季度（非季节），结果：Season.SPRING Season season = dateTime.seasonEnum(); //月份，结果：Month.JANUARY Month month = dateTime.monthEnum(); //日，结果：5 int day = dateTime.dayOfMonth();

对象的可变性

DateTime对象默认是可变对象（调用offset、setField、setTime方法默认变更自身），但是这种可变性有时候会引起很多问题（例如多个地方共用DateTime对象）。我们可以调用setMutable(false)方法使其变为不可变对象。在不可变模式下，offset、setField方法返回一个新对象，setTime方法抛出异常。

DateTime dateTime = new DateTime("2017-01-05 12:34:23", DatePattern.NORM_DATETIME_FORMAT); //默认情况下DateTime为可变对象，此时offset == dateTime DateTime offset = dateTime.offset(DateField.YEAR, 0); //设置为不可变对象后变动将返回新对象，此时offset != dateTime dateTime.setMutable(false); offset = dateTime.offset(DateField.YEAR, 0);

格式化为字符串

调用toString()方法即可返回格式为yyyy-MM-dd HH:mm:ss的字符串，调用toString(String format)可以返回指定格式的字符串

DateTime dateTime = new DateTime("2017-01-05 12:34:23", DatePattern.NORM_DATETIME_FORMAT); //结果：2017-01-05 12:34:23 String dateStr = dateTime.toString(); //结果：2017/01/05

农历日期-ChineseDate

使用

1、构建ChineseDate对象

ChineseDate表示了农历的对象，构建此对象既可以使用公历的日期，也可以使用农历的日期

//通过农历构建 ChineseDate chineseDate = new ChineseDate(1992,12,14); //通过公历构建 ChineseDate chineseDate = new ChineseDate(DateUtil.parseDate("1993-01-06"));

2、基本使用

//通过公历构建 ChineseDate date = new ChineseDate(DateUtil.parseDate("2020-01-25")); // 一月 date.getChineseMonth(); // 正月 date.getChineseMonthName(); // 初一 date.getChineseDay(); // 庚子 date.getCyclical(); // 生肖：鼠 date.getChineseZodiac(); // 传统节日（部分支持，逗号分隔）：春节 date.getFestivals(); // 庚子鼠年 正月初一 date.toString();

3、获取天干地支

从5.4.1开始，Hutool支持天干地支的获取

//通过公历构建 ChineseDate chineseDate = new ChineseDate(DateUtil.parseDate("2020-08-28")); // 庚子年甲申月癸卯日 String cyclicalYMD = chineseDate.getCyclicalYMD();

LocalDateTime工具-LocalDateTimeUtil

介绍：从Hutool的5.4.x开始，Hutool加入了针对JDK8+日期API的封装，此工具类的功能包括LocalDateTime和LocalDate的解析、格式化、转换等操作

使用

1、日期转换

String dateStr = "2020-01-23T12:23:56"; DateTime dt = DateUtil.parse(dateStr); // Date对象转换为LocalDateTime LocalDateTime of = LocalDateTimeUtil.of(dt); // 时间戳转换为LocalDateTime of = LocalDateTimeUtil.ofUTC(dt.getTime());

2、日期字符串解析

// 解析ISO时间 LocalDateTime localDateTime = LocalDateTimeUtil.parse("2020-01-23T12:23:56"); // 解析自定义格式时间 localDateTime = LocalDateTimeUtil.parse("2020-01-23", DatePattern.NORM_DATE_PATTERN);

3、解析同样支持LocalDate：

LocalDate localDate = LocalDateTimeUtil.parseDate("2020-01-23"); // 解析日期时间为LocalDate，时间部分舍弃 localDate = LocalDateTimeUtil.parseDate("2020-01-23T12:23:56", DateTimeFormatter.ISO_DATE_TIME);

4、日期格式化

LocalDateTime localDateTime = LocalDateTimeUtil.parse("2020-01-23T12:23:56"); // "2020-01-23 12:23:56" String format = LocalDateTimeUtil.format(localDateTime, DatePattern.NORM_DATETIME_PATTERN);

5、日期偏移

final LocalDateTime localDateTime = LocalDateTimeUtil.parse("2020-01-23T12:23:56"); // 增加一天 // "2020-01-24T12:23:56" LocalDateTime offset = LocalDateTimeUtil.offset(localDateTime, 1, ChronoUnit.DAYS);

如果是减少时间，offset第二个参数传负数即可：

// "2020-01-22T12:23:56" offset = LocalDateTimeUtil.offset(localDateTime, -1, ChronoUnit.DAYS);

6、计算时间间隔

LocalDateTime start = LocalDateTimeUtil.parse("2019-02-02T00:00:00"); LocalDateTime end = LocalDateTimeUtil.parse("2020-02-02T00:00:00"); Duration between = LocalDateTimeUtil.between(start, end); // 365 between.toDays();

7、一天的开始和结束

LocalDateTime localDateTime = LocalDateTimeUtil.parse("2020-01-23T12:23:56"); // "2020-01-23T00:00" LocalDateTime beginOfDay = LocalDateTimeUtil.beginOfDay(localDateTime); // "2020-01-23T23:59:59.999999999" LocalDateTime endOfDay = LocalDateTimeUtil.endOfDay(localDateTime);

计时器工具-TimeInterval

介绍：Hutool通过封装TimeInterval实现计时器功能，即可以计算方法或过程执行的时间。 TimeInterval支持分组计时，方便对比时间。

使用

TimeInterval timer = DateUtil.timer(); //--------------------------------- //-------这是执行过程 //--------------------------------- timer.interval();//花费毫秒数 timer.intervalRestart();//返回花费时间，并重置开始时间 timer.intervalMinute();//花费分钟数

也可以实现分组计时

final TimeInterval timer = new TimeInterval(); // 分组1 timer.start("1"); ThreadUtil.sleep(800); // 分组2 timer.start("2"); ThreadUtil.sleep(900); Console.log("Timer 1 took {} ms", timer.intervalMs("1")); Console.log("Timer 2 took {} ms", timer.intervalMs("2"));

HuTool简介与使用

Hutool是一个小而全的Java工具类库，通过静态方法封装，降低相关API的学习成本，提高工作效率，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”。

Hutool中的工具方法来自每个用户的精雕细琢，它涵盖了Java开发底层代码中的方方面面，它既是大型项目开发中解决小问题的利器，也是小型项目中的效率担当；

Hutool是项目中“util”包友好的替代，它节省了开发人员对项目中公用类和公用工具方法的封装时间，使开发专注于业务，同时可以最大限度的避免封装不完善带来的bug。

Hutool名称的由来

Hutool = Hu + tool，是原公司项目底层代码剥离后的开源库，“Hu”是公司名称的表示，tool表示工具。Hutool谐音“糊涂”，一方面简洁易懂，一方面寓意“难得糊涂”。

Hutool如何改变我们的coding方式

Hutool的目标是使用一个工具方法代替一段复杂代码，从而最大限度的避免“复制粘贴”代码的问题，彻底改变我们写代码的方式。

Hutool的存在就是为了减少代码搜索成本，避免网络上参差不齐的代码出现导致的bug。

安装与使用方式

Gradle

compile 'cn.hutool:hutool-all:5.7.9'