DateUtils工具类

import lombok.extern.slf4j.Slf4j;
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.util.*;

@Slf4j
public class DateUtils {

    //年月日格式
    public static final String DATE_FORMAT = "yyyy-MM-dd";
    public static final String DATE_FORMAT_CH = "yyyy年MM月dd日";
    public static final String DATETIME_FORMAT = "yyyy-MM-dd HH:mm:ss";
    public static final String DATETIME_FORMAT2 = "yyyyMMddHHmmss";
    public static final String DATETIME_FORMAT3 = "HH小时mm分钟ss秒";
    public static final String DATETIME_FORMAT_LINE = "yyyy-MM-dd HH";
    public static final String DEFAULT_TIMEZONE = "GMT+0:00";
    public static final String DATETIME_FORMAT4 = "yyyy-MM-dd'T'HH:mm:ss";
    public static final String EXCEL_DATETIME = "yyyyMMddHHmmss";
	public static final String DATETIME1_FORMAT = "yyyy-MM-dd HH:mm";


    /**
     * 一天的毫秒数
     */
    public static final long MILLISECONDS_PER_DAY = 24 * 60 * 60 * 1000;

    private static final SimpleDateFormat sdf_date_format = new SimpleDateFormat(DATE_FORMAT);

    private DateUtils() {
    }

    /**
     * @param date    日期
     * @param pattern 日期格式
     * @DESC 格式化日期
     * @author QYK
     * @time 2016-08-02
     */
    public static String formatDate(Date date, String pattern) {
        if (date == null) throw new IllegalArgumentException("date is null");
        if (pattern == null) throw new IllegalArgumentException("pattern is null");
        SimpleDateFormat formatter = new SimpleDateFormat(pattern, Locale.CHINESE);
        return formatter.format(date);
    }

    /**
     * 将时间转换为 {@value DATETIME_FORMAT} 格式的字符串，使用默认的区域信息。
     *
     * @param date 要格式化的日期，不可为 null
     * @throws IllegalArgumentException 参数为null时抛出此异常
     * @author zhouzhsh
     * @date 2020/10/22
     */
    public static String formatDatetime(Date date) throws IllegalArgumentException {
        if (date == null) throw new IllegalArgumentException("date should not be null");
        SimpleDateFormat formatter = new SimpleDateFormat(DATETIME_FORMAT);
        return formatter.format(date);
    }

    /**
     * 将时间转换为 {@value DATETIME_FORMAT} 格式的字符串，使用默认的区域信息。
     *
     * @param date 要格式化的日期
     * @return 当 date 参数为 null 时返回空串
     * @author zhouzhsh
     * @date 2020/10/22
     */
    public static String formatDatetimeOrEmpty(Date date) {
        if (date == null) return "";
        SimpleDateFormat formatter = new SimpleDateFormat(DATETIME_FORMAT);
        return formatter.format(date);
    }

    /**
     * 将时间转换为 {@value DATETIME_FORMAT} 格式的字符串，使用默认的区域信息。
     *
     * @param date 要格式化的日期
     * @return 当 date 参数为 null 时返回 null
     * @author zhouzhsh
     * @date 2020/10/22
     */
    public static String formatDatetimeOrNull(Date date) {
        if (date == null) return null;
        SimpleDateFormat formatter = new SimpleDateFormat(DATETIME_FORMAT);
        return formatter.format(date);
    }

    /**
     * 将 {@value DATETIME_FORMAT} 格式的字符串解析为 Date 对象，使用默认的区域信息。
     *
     * @param date 要解析的日期
     * @throws IllegalArgumentException 参数无法解析
     * @author zhouzhsh
     * @date 2020/12/07
     * @see Date
     */
    public static Date parseDatetime(String date) throws IllegalArgumentException {
        if (date == null) {
            throw new IllegalArgumentException("参数不可为 null");
        }
        SimpleDateFormat formatter = new SimpleDateFormat(DATETIME_FORMAT);
        try {
            return formatter.parse(date);
        } catch (ParseException e) {
            //throw new IllegalArgumentException("参数不符合格式：" + DATETIME_FORMAT);
            return parseSdfDate(date);
        }
    }

    /**
     * 将 {@value DATETIME_FORMAT} 格式的字符串解析为 Date 对象，使用默认的区域信息。
     *
     * @param dateStr 要解析的日期
     * @return 当参数无法解析，返回 null
     * @author zhouzhsh
     * @date 2020/12/07
     * @see Date
     */
    public static Date parseDatetimeOrNull(String dateStr) {
        if (StringUtils.isEmpty(dateStr)) {
            return null;
        }
        SimpleDateFormat formatter = new SimpleDateFormat(DATETIME_FORMAT);
        try {
            return formatter.parse(dateStr);
        } catch (Exception e) {
            //return null;
            return parseSdfDate(dateStr);
        }
    }

    public static LocalDateTime parseLocalDatetime(String dateStr) {
        if (StringUtils.isEmpty(dateStr)) {
            return null;
        }
        Date date = parseDatetime(dateStr);
        return date.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
    }

    /**
     * @param date
     * @return
     * @throws IllegalArgumentException
     */
    public static Date parseSdfDate(String date) throws IllegalArgumentException {
        if (date == null) {
            throw new IllegalArgumentException("参数不可为 null");
        }
        try {
            return sdf_date_format.parse(date);
        } catch (ParseException e) {
            throw new IllegalArgumentException("参数不符合格式：" + DATETIME_FORMAT);
        }
    }

    /**
     * 将 {@value DATETIME_FORMAT} 格式的字符串解析为 Date 对象，使用默认的区域信息。
     *
     * @param date 要解析的日期
     * @date 2022/09/02
     * @see Date
     */
    public static Date parseDatetime2(String date) throws ParseException {
        SimpleDateFormat formatter = new SimpleDateFormat(DATETIME_FORMAT);
        return formatter.parse(date);
    }


    public static String formatDate(Date date) {
        return formatDate(date, DATE_FORMAT);
    }

    /**
     * @param date   日期
     * @param offset 偏移量（offset= -1 代表上一个月，+1代表下一个月）
     * @DESC 获取根据当前月份的偏移月份
     * @author QYK
     * @time 2016-08-02
     */
    public static Date getMonthOffset(Date date, Integer offset) {
        Calendar cal = Calendar.getInstance();
        cal.setTime(date);
        cal.add(Calendar.MONTH, offset);
        return cal.getTime();
    }

    /**
     * 将日期字符串按指定格式转换成日期类型
     *
     * @param aMask   指定的日期格式，如:yyyy-MM-dd
     * @param strDate 待转换的日期字符串
     * @return
     * @throws ParseException
     * @author zhengxiaojun
     * @date 2018-11-22
     */
    public static final Date convertStringToDate(String aMask, String strDate)
            throws ParseException {
        if (strDate == null || "".equals(strDate)) {
            return null;
        }
        SimpleDateFormat df = null;
        Date date = null;
        df = new SimpleDateFormat(aMask);

        if (log.isDebugEnabled()) {
            log.debug("converting '" + strDate + "' to date with mask '" + aMask + "'");
        }
        try {
            date = df.parse(strDate);
        } catch (ParseException pe) {
            log.error("ParseException: " + pe);
            throw pe;
        }
        return (date);
    }

    public static final Date dateTime(final String date, final String format) {
        try {
            return new SimpleDateFormat(format).parse(date);
        } catch (ParseException e) {
            throw new RuntimeException(e);
        }
    }

    public static final Date convertStringToDate(String strDate) throws ParseException {
        if (StringUtils.isEmpty(strDate)) {
            return null;
        }
        if (strDate.length() == 10) {
            return convertStringToDate(DATE_FORMAT, strDate);
        } else if (strDate.length() == 13) {
            return convertStringToDate("yyyy-MM-dd HH", strDate);
        } else if (strDate.length() == 14) {
            return convertStringToDate(DATETIME_FORMAT2, strDate);
        } else {
            return convertStringToDate(DATETIME_FORMAT, strDate);
        }
    }

    public static final String convertFormatString(String strDate) throws ParseException {
        if (StringUtils.isEmpty(strDate)) {
            return null;
        }
        if (strDate.length() == 14) {
            return formatDatetime(convertStringToDate(DATETIME_FORMAT2, strDate));
        } else {
            return null;
        }
    }

    public static String getDate() {
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
        return sdf.format(new Date());
    }


    public static boolean checkDateStr(String dateStr, String pattern) {
        try {
            if (dateStr == null || dateStr.equals("")) {
                return false;
            }
            convertStringToDate(pattern, dateStr);
        } catch (Exception e) {
            return false;
        }
        return true;
    }

    /**
     * 返回日期加X天后的日期
     *
     * @param date
     * @param i
     * @return
     * @author Li Haolai
     * @date 2017-06-08
     */
    public static String addDay(String date, int i) {
        try {
            GregorianCalendar gCal = new GregorianCalendar(
                    Integer.parseInt(date.substring(0, 4)),
                    Integer.parseInt(date.substring(5, 7)) - 1,
                    Integer.parseInt(date.substring(8, 10)));
            gCal.add(GregorianCalendar.DATE, i);
            return sdf_date_format.format(gCal.getTime());
        } catch (Exception e) {
            log.debug("DateUtils.addDay():" + e.toString());
            return getDate();
        }
    }

    /**
     * 返回日期加X天后的日期
     *
     * @param date
     * @param i
     * @return
     */
    public static Date addDay(Date date, int i) {
        if (date == null) {
            return null;
        }
        return org.apache.commons.lang3.time.DateUtils.addDays(date, i);
    }

    public static Date addHour(Date date, int i) {
        if (date == null) {
            return null;
        }
        return org.apache.commons.lang3.time.DateUtils.addHours(date, i);
    }

    public static Date addMinute(Date date, int i) {
        if (date == null) {
            return null;
        }
        return org.apache.commons.lang3.time.DateUtils.addMinutes(date, i);
    }

    /**
     * 获取当前时间到几个月之后的日期
     *
     * @return
     */
    public static Date getNextMonth(Date createTime, int month, int day) {
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(createTime);
        calendar.set(Calendar.DAY_OF_MONTH, day);
        calendar.add(Calendar.MONTH, month);
        calendar.set(Calendar.HOUR_OF_DAY, 0);
        calendar.set(Calendar.MINUTE, 0);
        calendar.set(Calendar.SECOND, 0);
        calendar.set(Calendar.MILLISECOND, 0);
        return calendar.getTime();
    }

    /**
     * 获取今天0点0分0秒的日期对象
     *
     * @author zxh
     */
    public static Date getTodayZero() {
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(new Date());
        calendar.set(Calendar.HOUR_OF_DAY, 0);
        calendar.set(Calendar.MINUTE, 0);
        calendar.set(Calendar.SECOND, 0);
        calendar.set(Calendar.MILLISECOND, 0);
        Date zero = calendar.getTime();
        return zero;
    }

    /**
     * 获取前后 n 天的0点0分0秒的日期对象
     *
     * @return
     */
    public static Date getNextIntDayZero(int n) {
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(new Date());
        calendar.set(Calendar.HOUR_OF_DAY, 0);
        calendar.set(Calendar.MINUTE, 0);
        calendar.set(Calendar.SECOND, 0);
        calendar.set(Calendar.MILLISECOND, 0);
        calendar.add(Calendar.DATE, n);
        Date zero = calendar.getTime();
        return zero;
    }


    /**
     * 校验时期是否在当前时间前 offset 天内
     *
     * @param sDate
     * @param offset
     * @return
     */
    public static Boolean thisDateAfterToday(String sDate, int offset) {
        Date date = DateUtils.parseDatetimeOrNull(sDate);
        if (date == null) {
            return false;
        }
        Calendar cal = Calendar.getInstance();
        cal.setTime(new Date());
        cal.add(Calendar.DAY_OF_MONTH, offset);

        Date formatDate = cal.getTime();
        return date.after(formatDate);
    }

    /**
     * 根据时间 和时间格式 校验是否正确
     *
     * @param sDate  校验的日期
     * @param format 校验的格式
     * @return
     */
    public static boolean isLegalDate(String sDate, String format) {
        if ((sDate == null) || (sDate.length() != format.length())) {
            return false;
        }
        DateFormat formatter = new SimpleDateFormat(format);
        try {
            Date date = formatter.parse(sDate);
            return sDate.equals(formatter.format(date));
        } catch (Exception e) {
            return false;
        }
    }

    /**
     * 获取月份的第一天
     */
    public static String getMonthFirstDay(String month) {
        try {
            Calendar calendar = Calendar.getInstance();
            calendar.set(Integer.parseInt(month.substring(0, 4)), Integer.parseInt(month.substring(5, 7)) - 1, 1);
            String firstDayOfMonth = new SimpleDateFormat("yyyy-MM-dd ").format(calendar.getTime());
            return firstDayOfMonth;
        } catch (Exception e) {
            return "";
        }
    }

    /**
     * 获取月份的最后一天
     */
    public static String getMonthEndDay(String month) {
        try {
            Calendar calendar = Calendar.getInstance();
            calendar.set(Integer.parseInt(month.substring(0, 4)), Integer.parseInt(month.substring(5, 7)), 1);//这里先设置要获取月份的下月的第一天
            calendar.add(Calendar.DATE, -1);//这里将日期值减去一天，从而获取到要求的月份最后一天
            String lastDayOfMonth = new SimpleDateFormat("yyyy-MM-dd ").format(calendar.getTime());
            return lastDayOfMonth;
        } catch (Exception e) {
            return "";
        }
    }

    /**
     * 获取当年的第一天
     *
     * @return
     */
    public static Date getCurrYearFirst() {
        Calendar currCal = Calendar.getInstance();
        int currentYear = currCal.get(Calendar.YEAR);
        return getYearFirst(currentYear);
    }

    /**
     * 获取当年的最后一天
     *
     * @return
     */
    public static Date getCurrYearLast() {
        Calendar currCal = Calendar.getInstance();
        int currentYear = currCal.get(Calendar.YEAR);
        return getYearLast(currentYear);
    }


    /**
     * 获取某年第一天日期
     *
     * @param year 年份
     * @return Date
     */
    public static Date getYearFirst(int year) {
        Calendar calendar = Calendar.getInstance();
        calendar.clear();
        calendar.set(Calendar.YEAR, year);
        Date currYearFirst = calendar.getTime();
        return currYearFirst;
    }

    /**
     * 获取某年最后一天日期
     *
     * @param year 年份
     * @return Date
     */
    public static Date getYearLast(int year) {
        Calendar calendar = Calendar.getInstance();
        calendar.clear();
        calendar.set(Calendar.YEAR, year);
        calendar.roll(Calendar.DAY_OF_YEAR, -1);
        Date currYearLast = calendar.getTime();

        return currYearLast;
    }

    /**
     * 获得当天开始时刻
     *
     * @return
     */
    public static Date initDateByDay() {
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(new Date());
        calendar.set(Calendar.HOUR_OF_DAY, 0);
        calendar.set(Calendar.MINUTE, 0);
        calendar.set(Calendar.SECOND, 0);
        return calendar.getTime();
    }

    /**
     * 获得20天前开始时刻
     *
     * @return
     */
    public static Date initDateByDayDeThree() {
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(new Date());
        calendar.set(Calendar.HOUR_OF_DAY, -72);
        calendar.set(Calendar.MINUTE, 0);
        calendar.set(Calendar.SECOND, 0);
        return calendar.getTime();
    }

    /**
     * 获得当天结束时刻
     *
     * @return
     */
    public static Date endDateByDay() {
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(new Date());
        calendar.set(Calendar.HOUR_OF_DAY, 23);
        calendar.set(Calendar.MINUTE, 59);
        calendar.set(Calendar.SECOND, 59);
        calendar.set(Calendar.MILLISECOND, 999);
        return calendar.getTime();
    }

    /**
     * 获得当月开始时刻
     *
     * @return
     */
    public static Date initDateByMonth() {
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(new Date());
        calendar.add(Calendar.MONTH, 0);
        calendar.set(Calendar.DAY_OF_MONTH, 1);
        calendar.set(Calendar.HOUR_OF_DAY, 0);
        calendar.set(Calendar.MINUTE, 0);
        calendar.set(Calendar.SECOND, 0);
        calendar.set(Calendar.MILLISECOND, 0);
        return calendar.getTime();
    }

    /**
     * 获得上个月开始时刻
     *
     * @return
     */
    public static Date getLastMonthInit() {
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(new Date());
        calendar.add(Calendar.MONTH, -1);
        calendar.set(Calendar.DAY_OF_MONTH, 1);
        calendar.set(Calendar.HOUR_OF_DAY, 0);
        calendar.set(Calendar.MINUTE, 0);
        calendar.set(Calendar.SECOND, 0);
        calendar.set(Calendar.MILLISECOND, 0);
        return calendar.getTime();
    }

    /**
     * 获得当月最后时刻
     *
     * @return
     */
    public static Date endDateByMonth() {
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(new Date());
        calendar.add(Calendar.MONTH, 1);
        calendar.set(Calendar.DAY_OF_MONTH, 0);
        calendar.set(Calendar.HOUR_OF_DAY, 23);
        calendar.set(Calendar.MINUTE, 59);
        calendar.set(Calendar.SECOND, 59);
        return calendar.getTime();
    }

    /**
     * 判断当前时间是否在[startTime, endTime]区间，注意时间格式要一致
     *
     * @param nowTime   当前时间
     * @param startTime 开始时间
     * @param endTime   结束时间
     * @return
     */
    public static boolean isEffectiveDate(Date nowTime, Date startTime, Date endTime) {
        if (startTime == null && endTime == null) {
            return true;
        }
        if (nowTime == null) {
            return false;
        }

        Calendar date = Calendar.getInstance();
        date.setTime(nowTime);
        Calendar begin = null;
        if (startTime != null) {
            begin = Calendar.getInstance();
            begin.setTime(startTime);
        }
        Calendar end = null;
        if (endTime != null) {
            end = Calendar.getInstance();
            end.setTime(endTime);
        }

        if (begin == null) {
            return date.before(end) || nowTime.getTime() == endTime.getTime();
        }
        if (end == null) {
            return date.after(begin) || nowTime.getTime() == startTime.getTime();
        }
        if (nowTime.getTime() == startTime.getTime()
                || nowTime.getTime() == endTime.getTime()) {
            return true;
        }
        return date.after(begin) && date.before(end);
    }

    /**
     * 获取当前日期
     *
     * @return
     */
    public static String getNowDate2Str() {
        return getNowDate2Str(DateUtils.DATETIME_FORMAT);
    }

    public static String getNowDate2Str(String dateFormat) {
        return DateUtils.formatDate(new Date(), dateFormat);
    }

    /**
     * 秒转化为小时-分钟-秒
     *
     * @param seconds
     * @return
     */
    public static String convertSeconds2Date(long seconds) {
        String result = null;
        try {
            Date date = new Date(seconds * 1000);

            SimpleDateFormat df = new SimpleDateFormat(DATETIME_FORMAT3);
            df.setTimeZone(TimeZone.getTimeZone(DEFAULT_TIMEZONE));
            result = df.format(date);
        } catch (Exception e) {
            log.error("时间转换异常:", e);
        }
        return result;
    }


    /**
     * yyyy-MM-dd'T'HH:mm:ss.SSS 转换为时间
     *
     * @param dateStr
     * @return
     * @throws ParseException
     */
    public static Date parseDatetimeOrNull4(String dateStr) {
        try {
            if (dateStr == null) return null;
            SimpleDateFormat formatter = new SimpleDateFormat(DATETIME_FORMAT4);
            return formatter.parse(dateStr);
        } catch (Exception e) {
            log.error("时间转换异常:", e);
        }
        return null;
    }

    /**
     * 计算两个日期相差的天数。
     * <ul>
     *     <li>以毫秒进行计算，每{@value MILLISECONDS_PER_DAY}毫秒为1天；</li>
     *     <li>向下取整，不足{@value MILLISECONDS_PER_DAY}毫秒视为0天；</li>
     *     <li>计算结果为绝对值，与参数的顺序无关。</li>
     * </ul>
     *
     * @author zhouzhsh 2022/7/20
     */
    public static int dateDiffInDays(Date date1, Date date2) {
        if (date1 == null || date2 == null) {
            throw new IllegalArgumentException("日期参数为空");
        }
        return (int) (Math.abs(date1.getTime() - date2.getTime()) / MILLISECONDS_PER_DAY);
    }

    /**
     * 计算两个日期相差秒
     *
     * @param date1
     * @param date2
     * @return
     */
    public static long dateDiffInMilliseconds(Date date1, Date date2) {
        if (date1 == null || date2 == null) {
            throw new IllegalArgumentException("日期参数为空");
        }
        return (long) (Math.abs(date1.getTime() - date2.getTime()) / 1000);
    }

    /**
     * 获取当天开始时间
     *
     * @param date
     * @return
     */
    public static Date getDayStartTime(Date date) {
        if (date == null) {
            return null;
        }
        return DateUtils.parseDatetimeOrNull(DateUtils.formatDate(date, DateUtils.DATE_FORMAT));
    }

    /**
     * 获取当天结束时间
     *
     * @param date
     * @return
     */
    public static Date getDayEndTime(Date date) {
        if (date == null) {
            return null;
        }
        Calendar calendar = Calendar.getInstance();
        calendar.setTime(date);
        calendar.set(Calendar.HOUR_OF_DAY, 23);
        calendar.set(Calendar.MINUTE, 59);
        calendar.set(Calendar.SECOND, 59);
        return calendar.getTime();
    }

    /**
     * 获取一周中的某一天
     *
     * @param whichDay
     * @return
     */
    public static Date getDayOfWeek(int whichDay) {
        Calendar cld = Calendar.getInstance(Locale.CHINA);
        cld.setFirstDayOfWeek(Calendar.MONDAY);//以周一为首日
        cld.setTimeInMillis(System.currentTimeMillis());//当前时间

        cld.set(Calendar.DAY_OF_WEEK, whichDay);
        return cld.getTime();
    }

    public static Date fromLocalDate(LocalDateTime localDateTime) {
        if (localDateTime == null) {
            return null;
        }
        return Date.from(localDateTime.atZone(ZoneId.systemDefault()).toInstant());
    }

    public static String formatDateTime(LocalDateTime localDateTime) {
        if (localDateTime == null) {
            return null;
        }
        Date date = fromLocalDate(localDateTime);
        return formatDatetimeOrNull(date);
    }

}

参考：聊聊 SpringBoot 中的两种占位符：@@ 和 ${}

---

---

SpringBoot

#SpringBoot

DateUtils工具类

https://github.com/i-xiaoxin/2023/04/03/DateUtils工具类/

作者

xiaoxinlore

发布于

2023年4月3日

许可协议

Java 生成二维码图片 上一篇

LocalDateTime今天昨天判断 下一篇