時間工具類（java8版本）

記錄一個好用的時間工具類，包括了Date與String的相互轉(zhuǎn)換，日期的年、月、日、時、分、秒的加減處理，采用了java8的localDate，DateTimeFormatter來保證線程安全，后期會補錄一些獲取周一周天等實用的函數(shù)。

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 + "] 參數(shù)非法");
    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 + "] 參數(shù)非法");
    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 + "] 參數(shù)非法");
    return localDateTime.format(getFormatter(pattern));
}

/**
 * 字符串轉(zhuǎn)成 Date 類型
 *
 * @param str     日期字符串
 * @param pattern 日期的格式：如：DateUtils.DATE_PATTERN
 * @return Date 類型的時間
 */
public static Date toDate(String str, String pattern) {
    Assert.hasText(str, "STR: [" + str + "] 參數(shù)非法");
    Assert.hasText(pattern, "PATTERN: [" + pattern + "] 參數(shù)非法");
    return toDate(LocalDateTime.parse(str, getFormatter(pattern)));
}

/**
 * LocalDate 轉(zhuǎn)成 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 轉(zhuǎn)成 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());
}

/**
 * 字符串轉(zhuǎn)成 LocalDate 類型的日期 默認 str 形如 "yyyy-MM-dd"
 *
 * @param str 字符串日期
 * @return LocalDate 類型的日期
 */
public static LocalDate toLocalDate(String str) {
    Assert.hasText(str, "STR: [" + str + "] 參數(shù)非法");
    return toLocalDate(str, DATE_PATTERN);
}

/**
 * 字符串轉(zhuǎn)成 LocalDate 類型的日期
 *
 * @param str     字符串日期
 * @param pattern 字符串格式，如 DateUtils.DATE_PATTERN
 * @return LocalDate 類型的日期
 */
public static LocalDate toLocalDate(String str, String pattern) {
    Assert.hasText(str, "STR: [" + str + "] 參數(shù)非法");
    Assert.hasText(pattern, "PATTERN: [" + pattern + "] 參數(shù)非法");
    return LocalDate.parse(str, getFormatter(pattern));
}

/**
 * Date 類型日期轉(zhuǎn)成 LocalDate 類型的日期
 *
 * @param date Date 類型的日期
 * @return LocalDate 類型的日期
 */
public static LocalDate toLocalDate(Date date) {
    Assert.notNull(date, "傳入的日期不可以為 [null]");
    return toZonedDateTime(date).toLocalDate();
}

/**
 * 字符串類型的時間轉(zhuǎn)成 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 + "] 參數(shù)非法");
    return toLocalDateTime(str, DATE_TIME_PATTERN);
}

/**
 * 字符串類型的時間轉(zhuǎn)成 LocalDateTime 類型的時間
 *
 * @param str     字符串時間
 * @param pattern 字符串時間格式
 * @return LocalDateTime 類型的時間
 */
public static LocalDateTime toLocalDateTime(String str, String pattern) {
    Assert.hasText(str, "STR: [" + str + "] 參數(shù)非法");
    Assert.hasText(pattern, "PATTERN: [" + pattern + "] 參數(shù)非法");
    return LocalDateTime.parse(str, getFormatter(pattern));
}


/**
 * Date 類型的時間轉(zhuǎn)成 LocalDateTime 類型的時間
 *
 * @param date Date 類型的時間
 * @return LocalDateTime 類型的時間
 */
public static LocalDateTime toLocalDateTime(Date date) {
    Assert.notNull(date, "傳入的日期不可以為 [null]");
    return toZonedDateTime(date).toLocalDateTime();
}

/**
 * LocalDate 時間轉(zhuǎn)成 LocalDateTime 類型時間為當天開始時間
 *
 * @param localDate LocalDate 類型的時間
 * @return LocalDateTime 類型時間為當天開始時間
 */
public static LocalDateTime toLocalDateTime(LocalDate localDate) {
    Assert.notNull(localDate, "傳入的日期不可以為 [null]");
    return localDate.atStartOfDay();
}

/**
 * 對日期的【秒】進行加/減
 *
 * @param date    日期
 * @param seconds 秒數(shù)，負數(shù)為減
 * @return 加/減幾秒后的日期
 */
public static Date addDateSeconds(Date date, int seconds) {
    Assert.notNull(date, "傳入的日期不可以為 [null]");
    return toDate(toLocalDateTime(date).plusSeconds(seconds));
}

/**
 * 對日期的【分鐘】進行加/減
 *
 * @param date    日期
 * @param minutes 分鐘數(shù)，負數(shù)為減
 * @return 加/減幾分鐘后的日期
 */
public static Date addDateMinutes(Date date, int minutes) {
    Assert.notNull(date, "傳入的日期不可以為 [null]");
    return toDate(toLocalDateTime(date).plusMinutes(minutes));
}

/**
 * 對日期的【小時】進行加/減
 *
 * @param date  日期
 * @param hours 小時數(shù)，負數(shù)為減
 * @return 加/減幾小時后的日期
 */
public static Date addDateHours(Date date, int hours) {
    Assert.notNull(date, "傳入的日期不可以為 [null]");
    return toDate(toLocalDateTime(date).plusHours(hours));
}

/**
 * 對日期的【天】進行加/減
 *
 * @param date 日期
 * @param days 天數(shù)，負數(shù)為減
 * @return 加/減幾天后的日期
 */
public static Date addDateDays(Date date, int days) {
    Assert.notNull(date, "傳入的日期不可以為 [null]");
    return toDate(toLocalDateTime(date).plusDays(days));
}

/**
 * 對日期的【周】進行加/減
 *
 * @param date  日期
 * @param weeks 周數(shù)，負數(shù)為減
 * @return 加/減幾周后的日期
 */
public static Date addDateWeeks(Date date, int weeks) {
    Assert.notNull(date, "傳入的日期不可以為 [null]");
    return toDate(toLocalDateTime(date).plusWeeks(weeks));
}

/**
 * 對日期的【月】進行加/減
 *
 * @param date   日期
 * @param months 月數(shù)，負數(shù)為減
 * @return 加/減幾月后的日期
 */
public static Date addDateMonths(Date date, int months) {
    Assert.notNull(date, "傳入的日期不可以為 [null]");
    return toDate(toLocalDateTime(date).plusMonths(months));
}

/**
 * 對日期的【年】進行加/減
 *
 * @param date  日期
 * @param years 年數(shù)，負數(shù)為減
 * @return 加/減幾年后的日期
 */
public static Date addDateYears(Date date, int years) {
    Assert.notNull(date, "傳入的日期不可以為 [null]");
    return toDate(toLocalDateTime(date).plusYears(years));
}

/**
 * 從 Date 獲取特定時區(qū)的時間
 *
 * @param date Date 類型的時間
 * @return DateUtils.DEFAULT_ZONE_ID 標定的時區(qū)時間
 */
public static ZonedDateTime toZonedDateTime(Date date) {
    Assert.notNull(date, "傳入的日期不可以為 [null]");
    return date.toInstant().atZone(DEFAULT_ZONE_ID);
}

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

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

/**
 * 從 LocalDateTime 拿到秒數(shù)
 *
 * @param localDateTime localDateTime
 * @return 秒數(shù)
 */
public static long getSeconds(LocalDateTime localDateTime) {
    Assert.notNull(localDateTime, "傳入的日期不可以為 [null]");
    return getMillSeconds(localDateTime) / 1000;
}

/**
 * 從 LocalDateTime 拿到毫秒數(shù)
 *
 * @param localDateTime localDateTime
 * @return 毫秒數(shù)
 */
public static long getMillSeconds(LocalDateTime localDateTime) {
    Assert.notNull(localDateTime, "傳入的日期不可以為 [null]");
    return localDateTime.toInstant(DEFAULT_ZONE_OFFSET).toEpochMilli();
}

}

?著作權歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務。

友情鏈接更多精彩內(nèi)容