01HuTool-日期时间V1.0.1
2021-08-17 17:29:34 0 举报AI智能生成
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()方法获得其毫秒数。
时间枚举
概述
考虑到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:ssString now = DateUtil.now();//当前日期字符串，格式：yyyy-MM-ddString today= DateUtil.today();
转换
DateUtil.parse方法会自动识别一些常用格式，包括以下常用
举例：String dateStr = \"2017-03-01\";Date date = DateUtil.parse(dateStr);String dateStr = \"2017-03-01\
字符串转日期
String dateStr = \"2017-03-01\
格式化日期输出
Date date = DateUtil.date();//获得年的部分DateUtil.year(date);//获得月份，从0开始计数DateUtil.month(date);//获得月份枚举DateUtil.monthEnum(date);//.....
获取Date对象的某个部分
String dateStr = \"2017-03-01 22:33:23\";Date date = DateUtil.parse(dateStr);//一天的开始，结果：2017-03-01 00:00:00Date beginOfDay = DateUtil.beginOfDay(date);//一天的结束，结果：2017-03-01 23:59:59Date endOfDay = DateUtil.endOfDay(date);
有的时候我们需要获得每天的开始时间、结束时间，每月的开始和结束时间等等，DateUtil也提供了相关方法：
开始和结束时间
String dateStr = \"2017-03-01 22:33:23\
日期或时间的偏移指针对某个日期增加或减少分、小时、天等等，达到日期变更的目的。Hutool也针对其做了大量封装
//昨天DateUtil.yesterday()//明天DateUtil.tomorrow()//上周DateUtil.lastWeek()//下周DateUtil.nextWeek()//上个月DateUtil.lastMonth()//下个月DateUtil.nextMonth()
针对当前时间，提供了简化的偏移方法（例如昨天、上周、上个月等）：
日期时间偏移
String dateStr1 = \"2017-03-01 22:33:23\";Date date1 = DateUtil.parse(dateStr1);String dateStr2 = \"2017-04-01 23:33:23\
有时候我们需要计算两个日期之间的时间差（相差天数、相差小时数等等），Hutool将此类方法封装为between方法：
日期时间差
有时候我们希望看到易读的时间差，比如XX天XX小时XX分XX秒，此时使用DateUtil.formatBetween方法：
格式化时间差
// \"摩羯座\
星座和属相
//年龄DateUtil.ageOfNow(\"1990-01-30\");//是否闰年DateUtil.isLeapYear(2017);
其他
方法
日期时间工具-DateUtil
考虑工具类的局限性，在某些情况下使用并不简便，于是DateTime类诞生。DateTime对象充分吸取Joda-Time库的优点，并提供更多的便捷方法，这样我们在开发时不必再单独导入Joda-Time库便可以享受简单快速的日期时间处理过程。DateTime类继承于java.util.Date类，为Date类扩展了众多简便方法，这些方法多是DateUtil静态方法的对象表现形式，使用DateTime对象可以完全替代开发中Date对象的使用。
Date date = new Date(); //new方式创建DateTime time = new DateTime(date);Console.log(time);//of方式创建DateTime now = DateTime.now();DateTime dt = DateTime.of(date);
Date Calendar String(日期字符串，第二个参数是日期格式) long 毫秒数
DateTime对象包含众多的构造方法，构造方法支持的参数有：构建对象有两种方式：DateTime.of()和new DateTime()：
使用方法
DateTime dateTime = new DateTime(\"2017-01-05 12:34:23\
DateTime的成员方法与DateUtil中的静态方法所对应，因为是成员方法，因此可以使用更少的参数操作日期时间。
使用对象
DateTime对象默认是可变对象（调用offset、setField、setTime方法默认变更自身），但是这种可变性有时候会引起很多问题（例如多个地方共用DateTime对象）。我们可以调用setMutable(false)方法使其变为不可变对象。在不可变模式下，offset、setField方法返回一个新对象，setTime方法抛出异常。
对象的可变性
调用toString()方法即可返回格式为yyyy-MM-dd HH:mm:ss的字符串，调用toString(String format)可以返回指定格式的字符串
格式化为字符串
日期时间对象-DateTime
ChineseDate表示了农历的对象，构建此对象既可以使用公历的日期，也可以使用农历的日期
1、构建ChineseDate对象
//通过公历构建ChineseDate date = new ChineseDate(DateUtil.parseDate(\"2020-01-25\"));// 一月date.getChineseMonth();// 正月date.getChineseMonthName();// 初一date.getChineseDay();// 庚子date.getCyclical();// 生肖：鼠date.getChineseZodiac();// 传统节日（部分支持，逗号分隔）：春节date.getFestivals();// 庚子鼠年 正月初一date.toString();
2、基本使用
//通过公历构建ChineseDate chineseDate = new ChineseDate(DateUtil.parseDate(\"2020-08-28\"));// 庚子年甲申月癸卯日String cyclicalYMD = chineseDate.getCyclicalYMD();
从5.4.1开始，Hutool支持天干地支的获取
3、获取天干地支
使用
农历日期-ChineseDate
介绍：从Hutool的5.4.x开始，Hutool加入了针对JDK8+日期API的封装，此工具类的功能包括LocalDateTime和LocalDate的解析、格式化、转换等操作
String dateStr = \"2020-01-23T12:23:56\";DateTime dt = DateUtil.parse(dateStr);// Date对象转换为LocalDateTimeLocalDateTime of = LocalDateTimeUtil.of(dt);// 时间戳转换为LocalDateTimeof = LocalDateTimeUtil.ofUTC(dt.getTime());
1、日期转换
// 解析ISO时间LocalDateTime localDateTime = LocalDateTimeUtil.parse(\"2020-01-23T12:23:56\");// 解析自定义格式时间localDateTime = LocalDateTimeUtil.parse(\"2020-01-23\
2、日期字符串解析
LocalDate localDate = LocalDateTimeUtil.parseDate(\"2020-01-23\");// 解析日期时间为LocalDate，时间部分舍弃localDate = LocalDateTimeUtil.parseDate(\"2020-01-23T12:23:56\
3、解析同样支持LocalDate：
LocalDateTime localDateTime = LocalDateTimeUtil.parse(\"2020-01-23T12:23:56\");// \"2020-01-23 12:23:56\
4、日期格式化
final LocalDateTime localDateTime = LocalDateTimeUtil.parse(\"2020-01-23T12:23:56\");// 增加一天// \"2020-01-24T12:23:56\
// \"2020-01-22T12:23:56\
如果是减少时间，offset第二个参数传负数即可：
5、日期偏移
LocalDateTime start = LocalDateTimeUtil.parse(\"2019-02-02T00:00:00\");LocalDateTime end = LocalDateTimeUtil.parse(\"2020-02-02T00:00:00\
6、计算时间间隔
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);
7、一天的开始和结束
LocalDateTime工具-LocalDateTimeUtil
介绍：Hutool通过封装TimeInterval实现计时器功能，即可以计算方法或过程执行的时间。TimeInterval支持分组计时，方便对比时间。
TimeInterval timer = DateUtil.timer();//---------------------------------//-------这是执行过程//---------------------------------timer.interval();//花费毫秒数timer.intervalRestart();//返回花费时间，并重置开始时间timer.intervalMinute();//花费分钟数
final TimeInterval timer = new TimeInterval();// 分组1timer.start(\"1\");ThreadUtil.sleep(800);// 分组2timer.start(\"2\");ThreadUtil.sleep(900);Console.log(\"Timer 1 took {} ms\
也可以实现分组计时
计时器工具-TimeInterval
日期时间
Hutool是一个小而全的Java工具类库，通过静态方法封装，降低相关API的学习成本，提高工作效率，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”。
Hutool中的工具方法来自每个用户的精雕细琢，它涵盖了Java开发底层代码中的方方面面，它既是大型项目开发中解决小问题的利器，也是小型项目中的效率担当；
Hutool是项目中“util”包友好的替代，它节省了开发人员对项目中公用类和公用工具方法的封装时间，使开发专注于业务，同时可以最大限度的避免封装不完善带来的bug。
Hutool = Hu + tool，是原公司项目底层代码剥离后的开源库，“Hu”是公司名称的表示，tool表示工具。Hutool谐音“糊涂”，一方面简洁易懂，一方面寓意“难得糊涂”。
Hutool名称的由来
Hutool的目标是使用一个工具方法代替一段复杂代码，从而最大限度的避免“复制粘贴”代码的问题，彻底改变我们写代码的方式。
Hutool的存在就是为了减少代码搜索成本，避免网络上参差不齐的代码出现导致的bug。
Hutool如何改变我们的coding方式
compile 'cn.hutool:hutool-all:5.7.9'
Gradle
此处只介绍android方便的使用方式
更多安装使用方法，请参考官方网站。https://www.hutool.cn/docs/#/
安装与使用方式
HuTool简介与使用
说明：一个Java基础工具类，对文件、流、加密解密、转码、正则、线程、XML等JDK方法进行封装，组成各种Util工具类
介绍：JDK动态代理封装，提供非IOC下的切面支持
hutool-aop
介绍：布隆过滤，提供一些Hash算法的布隆过滤
hutool-bloomFilter
介绍：简单缓存实现
hutool-cache
介绍：核心，包括Bean操作、日期、各种Util等
hutool-core
介绍：定时任务模块，提供类Crontab表达式的定时任务
hutool-cron
介绍：加密解密模块，提供对称、非对称和摘要算法封装
hutool-crypto
介绍：JDBC封装后的数据操作，基于ActiveRecord思想
hutool-db
介绍：基于DFA模型的多关键字查找
hutool-dfa
介绍：扩展模块，对第三方封装（模板引擎、邮件、Servlet、二维码、Emoji、FTP、分词等）
hutool-extra
介绍：基于HttpUrlConnection的Http客户端封装
hutool-http
介绍：自动识别日志实现的日志门面
hutool-log
介绍：脚本执行封装，例如Javascript
hutool-script
介绍：功能更强大的Setting配置文件和Properties封装
hutool-setting
介绍：系统参数调用封装（JVM信息等）
hutool-system
介绍：JSON实现
hutool-json
介绍：图片验证码实现
hutool-captcha
介绍：针对POI中Excel和Word的封装
hutool-poi
介绍：基于Java的NIO和AIO的Socket封装
hutool-socket
介绍：JSON Web Token (JWT)封装实现
hutool-jwt
包含组件
HuTool包含组件
HuTool-日期时间V1.0.1
0 条评论
回复 删除
下一页
