Appearance
日期
说明
| 类名 | 类型 | 用途 |
|---|---|---|
| DateUtils | 工具类 | 日期工具类，继承自org.apache.commons.lang3.time.DateUtils |
| DateFormatUtils | 工具类 | 日期格式化工具类，继承自org.apache.commons.lang3.time.DateFormatUtils |
日期处理
io.github.pangju666.commons.lang.utils.DateUtils
NOTE
这个类的方法都是基于系统默认时区，如果需要指定时区请手动实现。
| 方法名 | 返回值 | 用途 |
|---|---|---|
| parseDate | Date | 将字符串解析为Date |
| nowDate | Date | 获取当前时间的Date |
| toDate | Date | 转换为Date对象 |
| toInstant | Instant | 将 Date 转换为 Instant |
| getTime | Long | 获取Date的时间戳 |
| betweenMillis | Long | 计算两个日期之间的毫秒差 |
| betweenSeconds | Long | 计算两个日期之间的秒数差 |
| betweenMinutes | Long | 计算两个日期之间的分钟差 |
| betweenHours | Long | 计算两个日期之间的小时差 |
| betweenDays | Long | 计算两个日期之间的天数差 |
| truncateBetweenYears | Integer | 计算两个日期之间的年份差（截断计算） |
| truncateBetweenMonths | Integer | 计算两个日期之间的月份差（截断计算） |
| truncateBetweenDays | Integer | 计算两个日期之间的天数差（截断计算） |
| truncateBetweenHours | Integer | 计算两个日期之间的小时差（截断计算） |
| truncateBetweenMinutes | Integer | 计算两个日期之间的分钟差（截断计算） |
| truncateBetweenSeconds | Integer | 计算两个日期之间的秒数差（截断计算） |
| truncateBetween | Integer | 通用截断计算时间差方法 |
| calculateAge | Integer | 计算年龄（基于年份差值） |
获取当前时间
java
DateUtils.nowDate();解析
java
// 解析失败会返回null
DateUtils.parseDate("2022-01-21");
DateUtils.parseDate("2022-01-21 12:20");
DateUtils.parseDate("2022-01-21 12:10:10");
DateUtils.parseDate("2022-01-21-12:10:10"); // null
// 解析失败则返回默认值
DateUtils.parseDateOrDefault("2022-01-21", new Date());
DateUtils.parseDateOrDefault("2022-01-21 12:20", new Date());
DateUtils.parseDateOrDefault("2022-01-21 12:10:10", new Date());
DateUtils.parseDateOrDefault("2022-01-21-12:10:10", new Date()); // new Date()
// 自定义解析表达式
DateUtils.parseDateOrDefault("2022-01-21", new Date(), Constants.DATE_FORMAT, Constants.DATETIME_FORMAT, "yyyy-MM-dd HH:mm");
DateUtils.parseDateOrDefault("2022-01-21 12:20", new Date(), Constants.DATE_FORMAT, Constants.DATETIME_FORMAT, "yyyy-MM-dd HH:mm");
DateUtils.parseDateOrDefault("2022-01-21 12:10:10", new Date(), Constants.DATE_FORMAT, Constants.DATETIME_FORMAT, "yyyy-MM-dd HH:mm");
DateUtils.parseDateOrDefault("2022-01-21-12:10:10", new Date(), Constants.DATE_FORMAT, Constants.DATETIME_FORMAT, "yyyy-MM-dd HH:mm"); // new Date()转换
java
// 时间戳转换为Date
DateUtils.toDate(1640995200000L); // 2022-01-01 08:00:00
// 转换失败返回null
Long timestamp = null;
DateUtils.toDate(timestamp); // null
// 转换失败返回默认值
DateUtils.toDate(timestamp, new Date()); // new Date()
// Instant转换为Date
DateUtils.toDate(Instant.now()); // 2022-01-01 08:00:00
// 转换失败返回null
Instant instant = null;
DateUtils.toDate(timestamp); // null
// 转换失败返回默认值
DateUtils.toDate(timestamp, Instant.now()); // new Date()转换为Instant
java
// 将Date转换为Instant
DateUtils.toInstant(new Date());
// 转换失败返回null
Date date = null;
DateUtils.toInstant(date); // null
// 转换失败返回默认值
DateUtils.toInstant(null, Instant.now());获取时间戳
java
// 获取时间戳
DateUtils.getTime(new Date()); // 1761408607462
// 获取失败返回null
Date date = null;
DateUtils.getTime(date); // null
// 获取失败返回默认值
DateUtils.getTime(date, 1761408607462L); // 1761408607462计算时间差
java
// 计算毫秒差
Date date1 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 0, 1).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from((LocalDateTime.of(2022, 1, 1, 8, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.betweenMillis(date1, date2); // 1000
// 计算秒差
Date date1 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 0, 1).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.betweenMillis(date1, date2); // 1
// 计算分钟差
Date date1 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 2, 0).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 1, 0).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.betweenMillis(date1, date2); // 1
// 计算小时差
Date date1 = Date.from(LocalDateTime.of(2022, 1, 1, 9, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.betweenHours(date1, date2); // 1
Date date3 = Date.from(LocalDateTime.of(2022, 1, 2, 8, 2, 0).atZone(ZoneId.systemDefault()).toInstant());
Date date4 = Date.from(LocalDateTime.of(2022, 1, 1, 9, 1, 0).atZone(ZoneId.systemDefault()).toInstant());
println DateUtils.betweenHours(date3, date4); // 23
// 计算天数差
Date date1 = Date.from(LocalDateTime.of(2022, 1, 2, 8, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.betweenDays(date1, date2); // 1截断计算时间差
java
// 计算年份差
Date date1 = Date.from(LocalDateTime.of(2022, 12, 1, 8, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2023, 1, 1, 8, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.truncateBetweenYears(date1, date2); // 1
// 计算月份差
Date date1 = Date.from(LocalDateTime.of(2023, 12, 1, 8, 0, 1).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.truncateBetweenMonths(date1, date2); // 11
// 计算天数差
Date date1 = Date.from(LocalDateTime.of(2022, 2, 12, 8, 2, 0).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 1, 0).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.truncateBetweenDays(date1, date2); // 11
// 计算小时差
Date date1 = Date.from(LocalDateTime.of(2022, 1, 2, 23, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 0, 0).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.truncateBetweenHours(date1, date2); // 3
// 计算分钟差
Date date1 = Date.from(LocalDateTime.of(2022, 1, 2, 9, 20, 0).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 10, 0).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.truncateBetweenMinutes(date1, date2); // 10
// 计算秒数差
Date date1 = Date.from(LocalDateTime.of(2022, 1, 2, 9, 20, 30).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 10, 10).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.truncateBetweenSeconds(date1, date2); // 20
// 通用计算时间差
Date date1 = Date.from(LocalDateTime.of(2022, 1, 2, 9, 20, 30).atZone(ZoneId.systemDefault()).toInstant());
Date date2 = Date.from(LocalDateTime.of(2022, 1, 1, 8, 10, 10).atZone(ZoneId.systemDefault()).toInstant());
DateUtils.truncateBetweenSeconds(date1, date2, Calendar.SECOND); // 20计算年龄
java
Date date = Date.from(LocalDate.of(1998, 6, 10));
DateUtils.calculateAge(date); // 27格式化
io.github.pangju666.commons.lang.utils.DateFormatUtils
| 方法名 | 返回值 | 用途 |
|---|---|---|
| formatDatetime | String | 使用 yyyy-MM-dd HH:mm:ss 格式化 |
| formatDate | String | 使用 yyyy-MM-dd 格式化 |
| formatTime | String | 使用 HH:mm:ss 格式化 |
日期和时间
java
DateFormatUtils.formatDatetime(); // 2025-10-26 01:15:19
DateFormatUtils.formatDatetime(new Date()); // 2025-10-26 01:15:19
DateFormatUtils.formatDatetime(new Date().getTime()); // 2025-10-26 01:15:19日期
java
DateFormatUtils.formatDate(); // 2025-10-26
DateFormatUtils.formatDate(new Date()); // 2025-10-26
DateFormatUtils.formatDate(new Date().getTime()); // 2025-10-26时间
java
DateFormatUtils.formatTime(); // 01:15:19
DateFormatUtils.formatTime(new Date()); // 01:15:19
DateFormatUtils.formatTime(new Date().getTime()); // 01:15:19