com.developcollect.dcinfra.utils.DateUtil Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of dc-infra Show documentation
Show all versions of dc-infra Show documentation
这是一个dc系列工具的基础包, 包含一些基础的类及依赖
package com.developcollect.dcinfra.utils;
import cn.hutool.core.date.DateUnit;
import cn.hutool.core.util.StrUtil;
import java.time.*;
import java.time.format.DateTimeFormatter;
import java.time.temporal.TemporalAdjusters;
import java.util.Arrays;
import java.util.Date;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.TimeUnit;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
/**
* @author zak
* @since 1.0.0
*/
public class DateUtil extends cn.hutool.core.date.DateUtil {
public static final String COMMON_DATE_TIME_PATTERN = "yyyy-MM-dd HH:mm:ss";
public static final String COMMON_DATE_PATTERN = "yyyy-MM-dd";
public static final String COMMON_TIME_PATTERN = "HH:mm:ss";
private static final Map DATETIME_FORMATTER_MAP;
static {
DATETIME_FORMATTER_MAP = new ConcurrentHashMap<>();
DATETIME_FORMATTER_MAP.put(COMMON_DATE_TIME_PATTERN, DateTimeFormatter.ofPattern(COMMON_DATE_TIME_PATTERN));
DATETIME_FORMATTER_MAP.put(COMMON_DATE_PATTERN, DateTimeFormatter.ofPattern(COMMON_DATE_PATTERN));
DATETIME_FORMATTER_MAP.put(COMMON_TIME_PATTERN, DateTimeFormatter.ofPattern(COMMON_TIME_PATTERN));
}
public static String format(LocalDate date, String format) {
DateTimeFormatter formatter = getFormatter(format);
return date.format(formatter);
}
public static String format(LocalDate date) {
return format(date, COMMON_DATE_PATTERN);
}
public static String format(LocalDateTime dateTime, String format) {
DateTimeFormatter formatter = getFormatter(format);
return dateTime.format(formatter);
}
public static String format(LocalDateTime dateTime) {
return format(dateTime, COMMON_DATE_TIME_PATTERN);
}
public static String format(LocalTime time, String format) {
DateTimeFormatter formatter = getFormatter(format);
return time.format(formatter);
}
public static String format(LocalTime time) {
return format(time, COMMON_TIME_PATTERN);
}
public static String format(Date date) {
return format(date, COMMON_DATE_TIME_PATTERN);
}
public static String formatNow(String format) {
return format(LocalDateTime.now(), format);
}
public static String formatDateTime(LocalDateTime dateTime) {
return format(dateTime, COMMON_DATE_TIME_PATTERN);
}
public static String formatDate(LocalDate date) {
return format(date, COMMON_DATE_PATTERN);
}
public static String formatDate(LocalDateTime dateTime) {
return format(dateTime, COMMON_DATE_PATTERN);
}
public static String formatTime(LocalTime time) {
return format(time, COMMON_TIME_PATTERN);
}
public static String formatTime(LocalDateTime dateTime) {
return format(dateTime, COMMON_TIME_PATTERN);
}
public static LocalDate parseLocalDate(CharSequence charSequence, String format) {
String dateStr = charSequence.toString();
DateTimeFormatter formatter = getFormatter(format);
LocalDate ld = LocalDate.parse(dateStr, formatter);
return ld;
}
public static LocalDate parseLocalDate(CharSequence charSequence) {
return parseLocalDate(charSequence, COMMON_DATE_PATTERN);
}
public static LocalTime parseLocalTime(CharSequence charSequence, String format) {
String timeStr = charSequence.toString();
DateTimeFormatter formatter = getFormatter(format);
LocalTime lt = LocalTime.parse(timeStr, formatter);
return lt;
}
public static LocalTime parseLocalTime(CharSequence charSequence) {
return parseLocalTime(charSequence, COMMON_TIME_PATTERN);
}
/**
* 以东8区时区取出指定日期距离1970-01-01T00:00:00Z.的毫秒数
*
* @param localDateTime 日期
* @return 毫秒数
*/
public static long toEpochMilli(LocalDateTime localDateTime) {
return localDateTime.atZone(zone()).toInstant().toEpochMilli();
}
/**
* 判断两个日期相差的时长，只保留绝对值
*
* @param beginDate 起始日期
* @param endDate 结束日期
* @param unit 相差的单位：相差 天{@link DateUnit#DAY}、小时{@link DateUnit#HOUR} 等
* @return 日期差
* @author zak
* @date 2019-10-16
*/
public static long between(LocalDateTime beginDate, LocalDateTime endDate, DateUnit unit) {
return between(beginDate, endDate, unit, true);
}
/**
* 判断两个日期相差的时长
*
* @param beginDate 起始日期
* @param endDate 结束日期
* @param unit 相差的单位：相差 天{@link DateUnit#DAY}、小时{@link DateUnit#HOUR} 等
* @param isAbs 日期间隔是否只保留绝对值正数
* @return 日期差
* @author zak
* @date 2019-10-16
*/
public static long between(LocalDateTime beginDate, LocalDateTime endDate, DateUnit unit, boolean isAbs) {
long beginMilli = toEpochMilli(beginDate);
long endMilli = toEpochMilli(endDate);
long diffMilli = endMilli - beginMilli;
long r = diffMilli / unit.getMillis();
return isAbs ? Math.abs(r) : r;
}
/**
* 以东8区时区把毫秒时间戳转为日期
*
* @param timestamp 毫秒时间戳
* @return 日期
*/
public static LocalDateTime localDateTime(long timestamp) {
return LocalDateTime.ofInstant(Instant.ofEpochMilli(timestamp), zone());
}
public static LocalDateTime localDateTime(Date date) {
Instant instant = date.toInstant();
ZoneId zone = zone();
LocalDateTime localDateTime = LocalDateTime.ofInstant(instant, zone);
return localDateTime;
}
public static boolean isIn(LocalTime time, LocalTime startTime, LocalTime endTime) {
final long start = startTime.toNanoOfDay();
final long end = endTime.toNanoOfDay();
final long specify = time.toNanoOfDay();
return specify >= start && specify <= end;
}
public static boolean isIn(LocalDate date, LocalDate startDate, LocalDate endDate) {
final long start = startDate.toEpochDay();
final long end = endDate.toEpochDay();
final long specify = date.toEpochDay();
return specify >= start && specify <= end;
}
public static boolean isIn(LocalDateTime dateTime, LocalDateTime startDateTime, LocalDateTime endDateTime) {
final long start = toEpochMilli(startDateTime);
final long end = toEpochMilli(endDateTime);
final long specify = toEpochMilli(dateTime);
return specify >= start && specify <= end;
}
private static ZoneId zone() {
//ZoneOffset.of("+8") 东八区
//ZoneId.systemDefault() 系统时区
return ZoneId.systemDefault();
}
private static DateTimeFormatter getFormatter(String format) {
DateTimeFormatter formatter = DATETIME_FORMATTER_MAP.get(format);
if (formatter == null) {
formatter = DateTimeFormatter.ofPattern(format);
DATETIME_FORMATTER_MAP.put(format, formatter);
}
return formatter;
}
private static Pattern DURATION_FORMAT_PATTERN = Pattern.compile("(H*)([^H]*?)(m+)([^m]*?)(s{1,2})");
/**
* 时长格式化, 将时长格式化为时分秒的格式
* HH:mm:ss
*
* @param milli 毫秒
* @param format 格式 常用: HH:mm:ss, H:m:s, mm:ss, m:s
* 小时占位符(H)可以省略, 但是分钟占位符(m)和秒占位符(s)不能缺少
* @return
*/
public static String formatDuration(long milli, String format) {
Matcher matcher = DURATION_FORMAT_PATTERN.matcher(format);
if (matcher.find()) {
String hFormat = matcher.group(1);
String sp1 = matcher.group(2);
String mFormat = matcher.group(3);
String sp2 = matcher.group(4);
String sFormat = matcher.group(5);
if (StrUtil.isNotBlank(mFormat) && StrUtil.isNotBlank(sFormat)) {
final String mPlaceholder;
final String sPlaceholder = sFormat.length() == 1 ? "%d" : "%02d";
// 不需要小时
if (StrUtil.isBlank(hFormat)) {
long m = milli / 1000 / 60;
long s = (milli - m * 1000 * 60) / 1000;
String mStr = String.valueOf(m);
if (mStr.length() < mFormat.length()) {
char[] pend = new char[mFormat.length() - mStr.length()];
Arrays.fill(pend, '0');
mStr = String.copyValueOf(pend) + mStr;
}
return matcher.replaceAll(String.format("%s" + sp2 + sPlaceholder, mStr, s));
} else {
long h = milli / 1000 / 60 / 60;
long m = (milli - h * 1000 * 60 * 60) / 1000 / 60;
long s = (milli - h * 1000 * 60 * 60 - m * 1000 * 60) / 1000;
String hStr = String.valueOf(h);
if (hStr.length() < hFormat.length()) {
char[] pend = new char[hFormat.length() - hStr.length()];
Arrays.fill(pend, '0');
hStr = String.copyValueOf(pend) + hStr;
}
mPlaceholder = mFormat.length() == 1 ? "%d" : "%02d";
return matcher.replaceAll(String.format("%s" + sp1 + mPlaceholder + sp2 + sPlaceholder, hStr, m, s));
}
}
}
throw new IllegalArgumentException("格式字符串不正确");
}
/**
* 时长格式化, 将时长格式化为时分秒的格式
*
* @param duration 时长
* @param timeUnit 单位
* @param format 格式
* @return java.lang.String
* @author zak
* @date 2019/12/21 16:19
*/
public static String formatDuration(long duration, TimeUnit timeUnit, String format) {
return formatDuration(timeUnit.toMillis(duration), format);
}
/**
* 今日零点
*
* @return
*/
public static LocalDateTime todayZeroTime() {
return beginOfDayLocalDateTime(LocalDateTime.now());
}
/**
* 今日23:59:59.999999999
*
* @return
*/
public static LocalDateTime todayEndTime() {
return endOfDayLocalDateTime(LocalDateTime.now());
}
/**
* 获取指定日期起始时间(零时零分零秒)
* 例如传入的是 2020/04/28 12:15:58, 将返回2020/04/28 00:00:00
*
* @return
*/
public static LocalDateTime beginOfDayLocalDateTime(LocalDateTime dateTime) {
return LocalDateTime.of(dateTime.toLocalDate(), LocalTime.MIN);
}
/**
* 获取指定日期起始时间(零时零分零秒)
* 例如传入的是 2020/04/28, 将返回2020/04/28 00:00:00
*
* @return
*/
public static LocalDateTime beginOfDayLocalDateTime(LocalDate date) {
return LocalDateTime.of(date, LocalTime.MIN);
}
/**
* 获取指定日期结束时间(23:59:59.999999999)
* 例如传入的是 2020/04/28 12:15:58, 将返回2020/04/28 23:59:59.999999999
*
* @return
*/
public static LocalDateTime endOfDayLocalDateTime(LocalDateTime dateTime) {
return endOfDayLocalDateTime(dateTime.toLocalDate());
}
/**
* 获取指定日期结束时间(23:59:59.999999999)
* 例如传入的是 2020/04/28, 将返回2020/04/28 23:59:59.999999999
*
* @return
*/
public static LocalDateTime endOfDayLocalDateTime(LocalDate time) {
return LocalDateTime.of(time, LocalTime.MAX);
}
/**
* 获取当前月份的第一天
* 例如现在是2020-04-28号，调用该方法获取的就是2020/04/01 00:00:00
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime beginOfMonthLocalDateTime() {
return beginOfMonthLocalDateTime(LocalDateTime.now());
}
/**
* 获取指定日期所在月份的第一天
* 例如传入的是2020-04-28号，调用该方法获取的就是2020/04/01 00:00:00
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime beginOfMonthLocalDateTime(LocalDateTime dateTime) {
final LocalDateTime firstDay = LocalDateTime.of(
beginOfMonthLocalDate(dateTime.toLocalDate()),
LocalTime.MIN
);
return firstDay;
}
/**
* 获取当前月份的第一天
* 例如现在是2020-04-28号，调用该方法获取的就是2020/04/01
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate beginOfMonthLocalDate() {
return beginOfMonthLocalDate(LocalDate.now());
}
/**
* 获取指定日期所在月份的第一天
* 例如传入的是2020-04-28号，调用该方法获取的就是2020/04/01 00:00:00
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate beginOfMonthLocalDate(LocalDate date) {
final LocalDate firstDay = date.with(TemporalAdjusters.firstDayOfMonth());
return firstDay;
}
/**
* 获取当前日期所在月份的最后一天
* 例如现在是2020-04-28号，调用该方法获取的就是2020/04/30 23:59:59.999999999
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime endOfMonthLocalDateTime() {
return endOfMonthLocalDateTime(LocalDateTime.now());
}
/**
* 获取当前日期所在月份的最后一天
* 例如现在是2020-04-28号，调用该方法获取的就是2020/04/30
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate endOfMonthLocalDate() {
return endOfMonthLocalDate(LocalDate.now());
}
/**
* 获取指定日期所在月份的最后一天
* 例如传入的是2020-04-28号，调用该方法获取的就是2020/04/30 23:59:59.999999999
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime endOfMonthLocalDateTime(LocalDateTime dateTime) {
final LocalDateTime firstDay = LocalDateTime.of(
endOfMonthLocalDate(dateTime.toLocalDate()),
LocalTime.MAX
);
return firstDay;
}
/**
* 获取指定日期所在月份的最后一天
* 例如传入的是2020-04-28号，调用该方法获取的就是2020/04/30
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate endOfMonthLocalDate(LocalDate date) {
final LocalDate firstDay = date.with(TemporalAdjusters.lastDayOfMonth());
return firstDay;
}
/**
* 获取当前日期所在年份的第一天
* 例如现在是2020-04-28号，调用该方法获取的就是2020/01/01 00:00:00
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime beginOfYearLocalDateTime() {
return beginOfYearLocalDateTime(LocalDateTime.now());
}
/**
* 获取当前日期所在年份的第一天
* 例如现在是2020-04-28号，调用该方法获取的就是2020/01/01
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate beginOfYearLocalDate() {
return beginOfYearLocalDate(LocalDate.now());
}
/**
* 获取指定日期所在年份的第一天
* 例如传入的是2020-04-28号，调用该方法获取的就是2020/01/01 00:00:00
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime beginOfYearLocalDateTime(LocalDateTime dateTime) {
final LocalDateTime firstDay = LocalDateTime.of(
beginOfYearLocalDate(dateTime.toLocalDate()),
LocalTime.MIN
);
return firstDay;
}
/**
* 获取指定日期所在年份的第一天
* 例如传入的是2020-04-28号，调用该方法获取的就是2020/01/01
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate beginOfYearLocalDate(LocalDate date) {
final LocalDate firstDay = date.with(TemporalAdjusters.firstDayOfYear());
return firstDay;
}
/**
* 获取当前日期所在年份的最后一天
* 例如现在是2020-04-28号，调用该方法获取的就是2020/12/31 23:59:59.999999999
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime endOfYearLocalDateTime() {
return endOfYearLocalDateTime(LocalDateTime.now());
}
/**
* 获取当前日期所在年份的最后一天
* 例如现在是2020-04-28号，调用该方法获取的就是2020/12/31
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate endOfYearLocalDate() {
return endOfYearLocalDate(LocalDate.now());
}
/**
* 获取指定日期所在年份的最后一天
* 例如传入的是2020-04-28号，调用该方法获取的就是2020/12/31 23:59:59.999999999
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime endOfYearLocalDateTime(LocalDateTime dateTime) {
final LocalDateTime firstDay = LocalDateTime.of(
endOfYearLocalDate(dateTime.toLocalDate()),
LocalTime.MAX
);
return firstDay;
}
/**
* 获取指定日期所在年份的最后一天
* 例如传入的是2020-04-28号，调用该方法获取的就是2020/12/31
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate endOfYearLocalDate(LocalDate date) {
final LocalDate firstDay = date.with(TemporalAdjusters.lastDayOfYear());
return firstDay;
}
/**
* 获取当前日期所在星期的第一天(星期一)
* 例如现在是2020-04-28号(星期二)，调用该方法获取的就是2020/04/27 00:00:00
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime beginOfWeekLocalDateTime() {
return beginOfWeekLocalDateTime(LocalDateTime.now());
}
/**
* 获取指定日期所在星期的第一天(星期一)
* 例如传入的是2020-04-28号(星期二)，调用该方法获取的就是2020/04/27 00:00:00
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime beginOfWeekLocalDateTime(LocalDateTime date) {
final LocalDateTime firstDay = LocalDateTime.of(beginOfWeekLocalDate(date.toLocalDate()), LocalTime.MIN);
return firstDay;
}
/**
* 获取当前日期所在星期的第一天(星期一)
* 例如现在是2020-04-28号(星期二)，调用该方法获取的就是2020/04/27
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate beginOfWeekLocalDate() {
return beginOfWeekLocalDate(LocalDate.now());
}
/**
* 获取指定日期所在星期的第一天(星期一)
* 例如传入的是2020-04-28号(星期二)，调用该方法获取的就是2020/04/27
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate beginOfWeekLocalDate(LocalDate date) {
final LocalDate firstDay = date.with(DayOfWeek.MONDAY);
return firstDay;
}
/**
* 获取当前日期所在星期最后一天(星期天)
* 例如现在是2020-04-28号(星期二)，调用该方法获取的就是2020/05/03
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate endOfWeekLocalDate() {
return beginOfWeekLocalDate(LocalDate.now());
}
/**
* 获取指定日期所在星期最后一天(星期天)
* 例如传入的是2020-04-28号(星期二)，调用该方法获取的就是2020/05/03
*
* @return java.time.LocalDate
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDate endOfWeekLocalDate(LocalDate date) {
final LocalDate firstDay = date.with(DayOfWeek.SUNDAY);
return firstDay;
}
/**
* 获取当前日期所在星期最后一天(星期天)
* 例如现在是2020-04-28号(星期二)，调用该方法获取的就是2020/05/03 23:59:59.999999999
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime endOfWeekLocalDateTime() {
return endOfWeekLocalDateTime(LocalDateTime.now());
}
/**
* 获取指定日期所在星期最后一天(星期天)
* 例如传入的是2020-04-28号(星期二)，调用该方法获取的就是2020/05/03 23:59:59.999999999
*
* @return java.time.LocalDateTime
* @author zak
* @date 2020/4/28 12:00
*/
public static LocalDateTime endOfWeekLocalDateTime(LocalDateTime date) {
final LocalDateTime firstDay = LocalDateTime.of(endOfWeekLocalDate(date.toLocalDate()), LocalTime.MAX);
return firstDay;
}
}