com.moon.core.time.DateUtil Maven / Gradle / Ivy

Go to download
package com.moon.core.time;

import com.moon.core.util.validator.ResidentID18Validator;

import java.sql.Time;
import java.sql.Timestamp;
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.time.LocalDate;
import java.util.Calendar;
import java.util.Date;

import static java.util.Calendar.*;

/**
 * 本类所有返回{@link Date}的方法均是返回新对象，而不是在原有对象上操作
 * 
 * 如：
 * 
 *     Date date = new Date();
 *     Date resultDate = DateUtil.clearTime(date);
 *     assertTrue(date != resultDate); // 传入对象和返回对象是不同的
 * 
 *
 * @author moonsky
 */
public final class DateUtil extends CalendarUtil {

    private DateUtil() { super(); }

    /*
     * -------------------------------------------------------------------------
     * is
     * -------------------------------------------------------------------------
     */

    public static boolean isToday(Date value) { return value != null && isSameDay(value, nowDate()); }

    public static boolean isSameDay(Date value, Date other) {
        return value != null && getYear(value) == getYear(other) && getMonth(value) == getMonth(other) && getDayOfMonth(
            value) == getDayOfMonth(other);
    }

    public static boolean isSameTime(Date value, Date other) {
        return value != null && getYear(value) == getYear(other) && getSecond(value) == getSecond(other) && getMonth(
            value) == getMonth(other) && getDayOfMonth(value) == getDayOfMonth(other) && getHour(value) == getHour(other) && getMinute(
            value) == getMinute(other);
    }

    public static boolean isBefore(Date value, Date other) {
        return value != null && value.getTime() < other.getTime();
    }

    public static boolean isAfter(Date value, Date other) {
        return value != null && value.getTime() > other.getTime();
    }

    public static boolean isBeforeNow(Date value) { return isBefore(value, nowDate()); }

    public static boolean isAfterNow(Date value) { return isAfter(value, nowDate()); }

    /*
     * -------------------------------------------------------------------------
     * now
     * -------------------------------------------------------------------------
     */

    public static Date nowDate() { return new Date(); }

    public static java.sql.Date nowSqlDate() { return new java.sql.Date(nowTimeMillis()); }

    public static Time nowSqlTime() { return new java.sql.Time(nowTimeMillis()); }

    public static Timestamp nowTimestamp() { return new Timestamp(nowTimeMillis()); }

    /*
     * -------------------------------------------------------------------------
     * clears
     * -------------------------------------------------------------------------
     */

    public static Date clearTime(Date value) {
        Calendar current = toCalendar(value);
        current.set(HOUR_OF_DAY, 0);
        current.set(MINUTE, 0);
        current.set(SECOND, 0);
        current.set(MILLISECOND, 0);
        return current.getTime();
    }

    public static Date clearMilliseconds(Date value) { return setMillisecond(toCalendar(value), 0).getTime(); }

    /*
     * -------------------------------------------------------------------------
     * get and set
     * -------------------------------------------------------------------------
     */

    public static Date setYear(Date value, int amount) { return setYear(toCalendar(value), amount).getTime(); }

    public static Date setMonth(Date value, int amount) { return setMonth(toCalendar(value), amount).getTime(); }

    public static Date setDayOfMonth(Date value, int amount) {
        return setDayOfMonth(toCalendar(value), amount).getTime();
    }

    public static Date setHour(Date value, int amount) { return setHourOfDay(toCalendar(value), amount).getTime(); }

    public static Date setMinute(Date value, int amount) {
        return setMinute(toCalendar(value), amount).getTime();
    }

    public static Date setSecond(Date value, int amount) {
        return setSecond(toCalendar(value), amount).getTime();
    }

    public static Date setMillisecond(Date value, int amount) {
        return setMillisecond(toCalendar(value), amount).getTime();
    }

    public static int getYear(Date value) { return getYear(toCalendar(value)); }

    public static int getMonth(Date value) { return getMonth(toCalendar(value)); }

    public static int getDayOfMonth(Date value) { return getDayOfMonth(toCalendar(value)); }

    public static int getHour(Date value) { return getHour(toCalendar(value)); }

    public static int getMinute(Date value) { return getMinute(toCalendar(value)); }

    public static int getSecond(Date value) { return getSecond(toCalendar(value)); }

    public static int getMillisecond(Date value) { return getMillisecond(toCalendar(value)); }

    /**
     * 根据日期获取年龄（周岁）
     *
     * @param date 日期
     *
     * @return 周岁
     *
     * @see ResidentID18Validator#getAge()
     */
    public static int getAge(Date date) {
        return DateTimeUtil.toDate(date).until(LocalDate.now()).getYears();
    }

    /**
     * 根据日期获取年龄（虚岁）
     *
     * @param date 日期
     *
     * @return 虚岁
     *
     * @see ResidentID18Validator#getNominalAge()
     */
    public static int getNominalAge(Date date) { return getAge(date) + 1; }

    /*
     * -------------------------------------------------------------------------
     * copies
     * -------------------------------------------------------------------------
     */

    public static Date copy(Date date) { return new Date(date.getTime()); }

    /*
     * -------------------------------------------------------------------------
     * parsers
     * -------------------------------------------------------------------------
     */

    public static Date parseToDate(CharSequence dateString){
        return transformDateTimeString(dateString, DateUtil::toDate, DateUtil::toDate);
    }

    public static Date parse(String dateString, String patten) {
        return parse(dateString, new SimpleDateFormat(patten));
    }

    public static Date parse(String dateString, DateFormat patten) {
        try {
            return patten.parse(dateString);
        } catch (ParseException | NullPointerException e) {
            throw new IllegalArgumentException(dateString, e);
        }
    }

    /*
     * -------------------------------------------------------------------------
     * converters
     * -------------------------------------------------------------------------
     */

    public static Time toSqlTime(Object value) {
        if (value == null) { return null; }
        if (value instanceof Time) { return (Time) value; }
        try {
            return new Time(toCalendar(value).getTimeInMillis());
        } catch (Throwable t) {
            throw new IllegalArgumentException("can not converter to java.sql.Time of value: " + value);
        }
    }

    public static Timestamp toTimestamp(Object value) {
        if (value == null) { return null; }
        if (value instanceof Timestamp) { return (Timestamp) value; }
        try {
            return new Timestamp(toCalendar(value).getTimeInMillis());
        } catch (Throwable t) {
            throw new IllegalArgumentException("can not converter to java.sql.Timestamp of value: " + value);
        }
    }

    public static java.sql.Date toSqlDate(Object value) {
        if (value == null) { return null; }
        if (value instanceof java.sql.Date) { return (java.sql.Date) value; }
        try {
            return new java.sql.Date(toCalendar(value).getTimeInMillis());
        } catch (Throwable t) {
            throw new IllegalArgumentException("can not converter to java.sql.Date of value: " + value);
        }
    }

    /*
     * to java.util.Date ============================================
     */

    public static Date toDate(long timestamp) { return new Date(timestamp); }

    public static Date toDate(Object value) {
        if (value == null) { return null; }
        if (value instanceof Date) { return (Date) value; }
        try {
            return toCalendar(value).getTime();
        } catch (Throwable t) {
            throw new IllegalArgumentException("can not converter to java.util.Date of value: " + value);
        }
    }

    /**
     * 解析成 Date 日期
     *
     * @param arguments 用 int 表示的年、月、日、时、分、秒、毫秒等一个或多个字段按顺序传入
     */
    public static Date toDate(int... arguments) { return toDate(toCalendar(arguments)); }

    /**
     * java.util.Calendar to java.util.Date
     *
     * @param value 带转换值
     *
     * @return 转换后的值
     */
    public static Date toDate(Calendar value) { return value == null ? null : value.getTime(); }

    /**
     * 解析成 Date 日期
     *
     * @param dateString 要求符合格式 "yyyy-MM-dd HH:mm:ss SSS" 的一个或多个字段（超出部分将忽略）
     */
    public static Date toDate(CharSequence dateString) { return parseToDate(dateString); }

    /**
     * 解析成 Date 日期
     *
     * @param arguments 用 String 表示的年、月、日、时、分、秒、毫秒等一个或多个字段按顺序传入
     */
    public static Date toDate(String... arguments) { return toDate(toCalendar(arguments)); }
}