时间工具类（java8版本）

记录一个好用的时间工具类，包括了Date与String的相互转换，日期的年、月、日、时、分、秒的加减处理，采用了java8的localDate，DateTimeFormatter来保证线程安全，后期会补录一些获取周一周天等实用的函数。

package com.nevertrouble.common.withspring.util;

import org.springframework.util.Assert;

import java.time.*;
import java.time.format.DateTimeFormatter;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;

public class DateUtil {

/**
 * 默认 zoneId
 */
private static final ZoneId DEFAULT_ZONE_ID = ZoneId.systemDefault();
private static final ZoneOffset DEFAULT_ZONE_OFFSET = DEFAULT_ZONE_ID.getRules().getOffset(Instant.now());

/**
 * 时间格式（yyyy-MM-dd）
 */
public static final String DATE_PATTERN = "yyyy-MM-dd";
private static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ofPattern(DATE_PATTERN);
/**
 * 时间格式（yyyy-MM-dd HH:mm:ss）
 */
public static final String DATE_TIME_PATTERN = "yyyy-MM-dd HH:mm:ss";
private static final DateTimeFormatter DATE_TIME_FORMATTER = DateTimeFormatter.ofPattern(DATE_TIME_PATTERN);

private static final Map<String, DateTimeFormatter> DATE_TIME_FORMATTER_MAP = new HashMap<>(2);

static {
    DATE_TIME_FORMATTER_MAP.put(DATE_PATTERN, DATE_FORMATTER);
    DATE_TIME_FORMATTER_MAP.put(DATE_TIME_PATTERN, DATE_TIME_FORMATTER);
}

/**
 * 从全局缓存中拿 pattern 对应的 formatter 或者新建
 *
 * @param pattern pattern
 * @return pattern 对应的 formatter
 */
private static DateTimeFormatter getFormatter(String pattern) {
    return DATE_TIME_FORMATTER_MAP.getOrDefault(pattern, DateTimeFormatter.ofPattern(pattern));
}

/**
 * 日期格式化为指定格式的字符串
 *
 * @param date    日期
 * @param pattern 格式，如：DateUtils.DATE_PATTERN
 * @return 返回指定格式字符串时间
 */
public static String format(Date date, String pattern) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    Assert.hasText(pattern, "PATTERN: [" + pattern + "] 参数非法");
    return formatLocalDateTime(toLocalDateTime(date), pattern);
}

/**
 * LocalDate 类型的日期格式化为指定格式的字符串
 *
 * @param localDate LocalDate 类型的日期
 * @param pattern   格式，如：DateUtils.DATE_PATTERN
 * @return 返回指定格式字符串时间
 */
public static String formartLocalDate(LocalDate localDate, String pattern) {
    Assert.notNull(localDate, "传入的日期不可以为 [null]");
    Assert.hasText(pattern, "PATTERN: [" + pattern + "] 参数非法");
    return formatLocalDateTime(toLocalDateTime(localDate), pattern);
}

/**
 * LocalDateTime 类型的时间格式化为指定格式的字符串
 *
 * @param localDateTime LocalDateTime 类型的时间
 * @param pattern       格式，如 DateUtils.DATE_PATTERN
 * @return 指定格式字符串时间
 */
public static String formatLocalDateTime(LocalDateTime localDateTime, String pattern) {
    Assert.notNull(localDateTime, "传入的日期不可以为 [null]");
    Assert.hasText(pattern, "PATTERN: [" + pattern + "] 参数非法");
    return localDateTime.format(getFormatter(pattern));
}

/**
 * 字符串转成 Date 类型
 *
 * @param str     日期字符串
 * @param pattern 日期的格式：如：DateUtils.DATE_PATTERN
 * @return Date 类型的时间
 */
public static Date toDate(String str, String pattern) {
    Assert.hasText(str, "STR: [" + str + "] 参数非法");
    Assert.hasText(pattern, "PATTERN: [" + pattern + "] 参数非法");
    return toDate(LocalDateTime.parse(str, getFormatter(pattern)));
}

/**
 * LocalDate 转成 Date
 *
 * @param localDate LocalDate 类型日期
 * @return Date 类型的日期
 */
public static Date toDate(LocalDate localDate) {
    Assert.notNull(localDate, "传入的日期不可以为 [null]");
    return Date.from(localDate.atStartOfDay(DEFAULT_ZONE_ID).toInstant());
}

/**
 * LocalDateTime 转成 Date
 *
 * @param localDateTime LocalDateTime 类型时间
 * @return Date 类型的时间
 */
public static Date toDate(LocalDateTime localDateTime) {
    Assert.notNull(localDateTime, "传入的日期不可以为 [null]");
    return Date.from(localDateTime.atZone(DEFAULT_ZONE_ID).toInstant());
}

/**
 * 字符串转成 LocalDate 类型的日期 默认 str 形如 "yyyy-MM-dd"
 *
 * @param str 字符串日期
 * @return LocalDate 类型的日期
 */
public static LocalDate toLocalDate(String str) {
    Assert.hasText(str, "STR: [" + str + "] 参数非法");
    return toLocalDate(str, DATE_PATTERN);
}

/**
 * 字符串转成 LocalDate 类型的日期
 *
 * @param str     字符串日期
 * @param pattern 字符串格式，如 DateUtils.DATE_PATTERN
 * @return LocalDate 类型的日期
 */
public static LocalDate toLocalDate(String str, String pattern) {
    Assert.hasText(str, "STR: [" + str + "] 参数非法");
    Assert.hasText(pattern, "PATTERN: [" + pattern + "] 参数非法");
    return LocalDate.parse(str, getFormatter(pattern));
}

/**
 * Date 类型日期转成 LocalDate 类型的日期
 *
 * @param date Date 类型的日期
 * @return LocalDate 类型的日期
 */
public static LocalDate toLocalDate(Date date) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    return toZonedDateTime(date).toLocalDate();
}

/**
 * 字符串类型的时间转成 LocalDateTime 类型的时间，默认形如 "yyyy-MM-dd HH:mm:ss"
 *
 * @param str 字符串时间，默认形如 "yyyy-MM-dd HH:mm:ss"
 * @return LocalDateTime 类型的时间
 */
public static LocalDateTime toLocalDateTime(String str) {
    Assert.hasText(str, "STR: [" + str + "] 参数非法");
    return toLocalDateTime(str, DATE_TIME_PATTERN);
}

/**
 * 字符串类型的时间转成 LocalDateTime 类型的时间
 *
 * @param str     字符串时间
 * @param pattern 字符串时间格式
 * @return LocalDateTime 类型的时间
 */
public static LocalDateTime toLocalDateTime(String str, String pattern) {
    Assert.hasText(str, "STR: [" + str + "] 参数非法");
    Assert.hasText(pattern, "PATTERN: [" + pattern + "] 参数非法");
    return LocalDateTime.parse(str, getFormatter(pattern));
}


/**
 * Date 类型的时间转成 LocalDateTime 类型的时间
 *
 * @param date Date 类型的时间
 * @return LocalDateTime 类型的时间
 */
public static LocalDateTime toLocalDateTime(Date date) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    return toZonedDateTime(date).toLocalDateTime();
}

/**
 * LocalDate 时间转成 LocalDateTime 类型时间为当天开始时间
 *
 * @param localDate LocalDate 类型的时间
 * @return LocalDateTime 类型时间为当天开始时间
 */
public static LocalDateTime toLocalDateTime(LocalDate localDate) {
    Assert.notNull(localDate, "传入的日期不可以为 [null]");
    return localDate.atStartOfDay();
}

/**
 * 对日期的【秒】进行加/减
 *
 * @param date    日期
 * @param seconds 秒数，负数为减
 * @return 加/减几秒后的日期
 */
public static Date addDateSeconds(Date date, int seconds) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    return toDate(toLocalDateTime(date).plusSeconds(seconds));
}

/**
 * 对日期的【分钟】进行加/减
 *
 * @param date    日期
 * @param minutes 分钟数，负数为减
 * @return 加/减几分钟后的日期
 */
public static Date addDateMinutes(Date date, int minutes) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    return toDate(toLocalDateTime(date).plusMinutes(minutes));
}

/**
 * 对日期的【小时】进行加/减
 *
 * @param date  日期
 * @param hours 小时数，负数为减
 * @return 加/减几小时后的日期
 */
public static Date addDateHours(Date date, int hours) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    return toDate(toLocalDateTime(date).plusHours(hours));
}

/**
 * 对日期的【天】进行加/减
 *
 * @param date 日期
 * @param days 天数，负数为减
 * @return 加/减几天后的日期
 */
public static Date addDateDays(Date date, int days) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    return toDate(toLocalDateTime(date).plusDays(days));
}

/**
 * 对日期的【周】进行加/减
 *
 * @param date  日期
 * @param weeks 周数，负数为减
 * @return 加/减几周后的日期
 */
public static Date addDateWeeks(Date date, int weeks) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    return toDate(toLocalDateTime(date).plusWeeks(weeks));
}

/**
 * 对日期的【月】进行加/减
 *
 * @param date   日期
 * @param months 月数，负数为减
 * @return 加/减几月后的日期
 */
public static Date addDateMonths(Date date, int months) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    return toDate(toLocalDateTime(date).plusMonths(months));
}

/**
 * 对日期的【年】进行加/减
 *
 * @param date  日期
 * @param years 年数，负数为减
 * @return 加/减几年后的日期
 */
public static Date addDateYears(Date date, int years) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    return toDate(toLocalDateTime(date).plusYears(years));
}

/**
 * 从 Date 获取特定时区的时间
 *
 * @param date Date 类型的时间
 * @return DateUtils.DEFAULT_ZONE_ID 标定的时区时间
 */
public static ZonedDateTime toZonedDateTime(Date date) {
    Assert.notNull(date, "传入的日期不可以为 [null]");
    return date.toInstant().atZone(DEFAULT_ZONE_ID);
}

/**
 * 从秒数拿到 LocalDateTime
 *
 * @param seconds 秒数
 * @return localDateTime
 */
public static LocalDateTime fromSeconds(long seconds) {
    return LocalDateTime.ofEpochSecond(seconds, 0, DEFAULT_ZONE_OFFSET);
}

/**
 * 从毫秒数拿到 LocalDateTime
 *
 * @param millSeconds 毫秒数
 * @return localDateTime
 */
public static LocalDateTime fromMillSeconds(long millSeconds) {
    Instant instant = Instant.ofEpochMilli(millSeconds);
    return LocalDateTime.ofInstant(instant, DEFAULT_ZONE_ID);
}

/**
 * 从 LocalDateTime 拿到秒数
 *
 * @param localDateTime localDateTime
 * @return 秒数
 */
public static long getSeconds(LocalDateTime localDateTime) {
    Assert.notNull(localDateTime, "传入的日期不可以为 [null]");
    return getMillSeconds(localDateTime) / 1000;
}

/**
 * 从 LocalDateTime 拿到毫秒数
 *
 * @param localDateTime localDateTime
 * @return 毫秒数
 */
public static long getMillSeconds(LocalDateTime localDateTime) {
    Assert.notNull(localDateTime, "传入的日期不可以为 [null]");
    return localDateTime.toInstant(DEFAULT_ZONE_OFFSET).toEpochMilli();
}

}