2025-11-15 zwy 对时间戳的工具类

zhaowenyu

2025-11-15 6904379440e2c1c3b8c4c868e9706bd563e7df7f

2025-11-15 zwy 对时间戳的工具类

 ard-sample/src/main/java/com/ard/sample/utils/TimestampUtils.java

New file
@@ -0,0 +1,257 @@
package com.ard.sample.utils;

import org.springframework.stereotype.Component;

import java.time.*;
import java.time.format.DateTimeFormatter;

/**
 * 时间戳工具类（支持毫秒级/秒级时间戳，基于Java 8+时间API）
 * 功能：加/减时间、转换为LocalDateTime、格式化字符串等
 */
@Component
public class TimestampUtils {

    // 默认时区：北京时间（Asia/Shanghai）
    private static final ZoneId DEFAULT_ZONE = ZoneId.of("Asia/Shanghai");

    // 默认日期时间格式：yyyy-MM-dd HH:mm:ss
    private static final DateTimeFormatter DEFAULT_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

    // 时间单位常量（毫秒）
    private static final long ONE_SECOND = 1000L;         // 1秒 = 1000毫秒
    private static final long ONE_MINUTE = 60 * ONE_SECOND; // 1分钟 = 60秒
    private static final long ONE_HOUR = 60 * ONE_MINUTE;   // 1小时 = 60分钟
    private static final long ONE_DAY = 24 * ONE_HOUR;      // 1天 = 24小时


    // -------------------------- 毫秒级时间戳操作 --------------------------

    /**
     * 毫秒级时间戳 + N天
     * @param millisTimestamp 原毫秒级时间戳（13位）
     * @param days 天数（正数加，负数减）
     * @return 计算后的毫秒级时间戳
     */
    public long plusDaysByMillis(long millisTimestamp, int days) {
        return Instant.ofEpochMilli(millisTimestamp)
                .plusMillis(days * ONE_DAY)
                .toEpochMilli();
    }

    /**
     * 毫秒级时间戳 + N小时
     * @param millisTimestamp 原毫秒级时间戳（13位）
     * @param hours 小时数（正数加，负数减）
     * @return 计算后的毫秒级时间戳
     */
    public long plusHoursByMillis(long millisTimestamp, int hours) {
        return Instant.ofEpochMilli(millisTimestamp)
                .plusMillis(hours * ONE_HOUR)
                .toEpochMilli();
    }

    /**
     * 毫秒级时间戳 + N分钟
     * @param millisTimestamp 原毫秒级时间戳（13位）
     * @param minutes 分钟数（正数加，负数减）
     * @return 计算后的毫秒级时间戳
     */
    public long plusMinutesByMillis(long millisTimestamp, int minutes) {
        return Instant.ofEpochMilli(millisTimestamp)
                .plusMillis(minutes * ONE_MINUTE)
                .toEpochMilli();
    }

    /**
     * 毫秒级时间戳 + N秒
     * @param millisTimestamp 原毫秒级时间戳（13位）
     * @param seconds 秒数（正数加，负数减）
     * @return 计算后的毫秒级时间戳
     */
    public long plusSecondsByMillis(long millisTimestamp, int seconds) {
        return Instant.ofEpochMilli(millisTimestamp)
                .plusMillis(seconds * ONE_SECOND)
                .toEpochMilli();
    }


    // -------------------------- 秒级时间戳操作 --------------------------

    /**
     * 秒级时间戳 + N天（自动转换为毫秒级计算，结果转回秒级）
     * @param secondTimestamp 原秒级时间戳（10位）
     * @param days 天数（正数加，负数减）
     * @return 计算后的秒级时间戳
     */
    public long plusDaysBySecond(long secondTimestamp, int days) {
        long millis = secondTimestamp * ONE_SECOND;
        long newMillis = plusDaysByMillis(millis, days);
        return newMillis / ONE_SECOND;
    }

    /**
     * 秒级时间戳 + N小时
     * @param secondTimestamp 原秒级时间戳（10位）
     * @param hours 小时数（正数加，负数减）
     * @return 计算后的秒级时间戳
     */
    public long plusHoursBySecond(long secondTimestamp, int hours) {
        long millis = secondTimestamp * ONE_SECOND;
        long newMillis = plusHoursByMillis(millis, hours);
        return newMillis / ONE_SECOND;
    }

    /**
     * 秒级时间戳 + N分钟
     * @param secondTimestamp 原秒级时间戳（10位）
     * @param minutes 分钟数（正数加，负数减）
     * @return 计算后的秒级时间戳
     */
    public long plusMinutesBySecond(long secondTimestamp, int minutes) {
        long millis = secondTimestamp * ONE_SECOND;
        long newMillis = plusMinutesByMillis(millis, minutes);
        return newMillis / ONE_SECOND;
    }

    /**
     * 秒级时间戳 + N秒
     * @param secondTimestamp 原秒级时间戳（10位）
     * @param seconds 秒数（正数加，负数减）
     * @return 计算后的秒级时间戳
     */
    public long plusSecondsBySecond(long secondTimestamp, int seconds) {
        return secondTimestamp + seconds; // 秒级直接加减，无需转毫秒
    }


    // -------------------------- 时间戳转换为LocalDateTime --------------------------

    /**
     * 毫秒级时间戳转换为LocalDateTime（默认时区：北京时间）
     * @param millisTimestamp 毫秒级时间戳（13位）
     * @return LocalDateTime对象
     */
    public LocalDateTime toLocalDateTimeByMillis(long millisTimestamp) {
        return LocalDateTime.ofInstant(
                Instant.ofEpochMilli(millisTimestamp),
                DEFAULT_ZONE
        );
    }

    /**
     * 秒级时间戳转换为LocalDateTime（默认时区：北京时间）
     * @param secondTimestamp 秒级时间戳（10位）
     * @return LocalDateTime对象
     */
    public LocalDateTime toLocalDateTimeBySecond(long secondTimestamp) {
        return LocalDateTime.ofInstant(
                Instant.ofEpochSecond(secondTimestamp), // 直接用ofEpochSecond处理秒级
                DEFAULT_ZONE
        );
    }


    // -------------------------- 时间戳格式化为字符串 --------------------------

    /**
     * 毫秒级时间戳格式化为字符串（默认格式：yyyy-MM-dd HH:mm:ss）
     * @param millisTimestamp 毫秒级时间戳（13位）
     * @return 格式化后的字符串
     */
    public String formatByMillis(long millisTimestamp) {
        return formatByMillis(millisTimestamp, DEFAULT_FORMATTER);
    }

    /**
     * 毫秒级时间戳格式化为自定义格式字符串
     * @param millisTimestamp 毫秒级时间戳（13位）
     * @param formatter 自定义格式器（如：DateTimeFormatter.ofPattern("yyyy/MM/dd")）
     * @return 格式化后的字符串
     */
    public String formatByMillis(long millisTimestamp, DateTimeFormatter formatter) {
        LocalDateTime dateTime = toLocalDateTimeByMillis(millisTimestamp);
        return dateTime.format(formatter);
    }

    /**
     * 秒级时间戳格式化为字符串（默认格式：yyyy-MM-dd HH:mm:ss）
     * @param secondTimestamp 秒级时间戳（10位）
     * @return 格式化后的字符串
     */
    public String formatBySecond(long secondTimestamp) {
        return formatBySecond(secondTimestamp, DEFAULT_FORMATTER);
    }

    /**
     * 秒级时间戳格式化为自定义格式字符串
     * @param secondTimestamp 秒级时间戳（10位）
     * @param formatter 自定义格式器
     * @return 格式化后的字符串
     */
    public String formatBySecond(long secondTimestamp, DateTimeFormatter formatter) {
        LocalDateTime dateTime = toLocalDateTimeBySecond(secondTimestamp);
        return dateTime.format(formatter);
    }

    /**
     * 取原时间戳的时间部分，与当前日期组合成新时间戳
     * @param originalTimestamp 原时间戳（毫秒，如System.currentTimeMillis()返回值）
     * @return 组合后的新时间戳（毫秒）
     */
    public Long combine( Long originalTimestamp) {
        // 1. 校验原时间戳合法性
        if (originalTimestamp == null || originalTimestamp < 0) {
            throw new IllegalArgumentException("原时间戳无效");
        }

        // 2. 解析原时间戳，提取时间部分（时、分、秒、毫秒）
        // 原时间戳转换为ZonedDateTime（带时区的日期时间）
        ZonedDateTime originalZoned = Instant.ofEpochMilli(originalTimestamp)
                .atZone(DEFAULT_ZONE);
        // 提取时间部分：时、分、秒、纳秒（纳秒需转换为毫秒级精度）
        int hour = originalZoned.getHour();
        int minute = originalZoned.getMinute();
        int second = originalZoned.getSecond();
        int nanoOfSecond = originalZoned.getNano(); // 纳秒（1毫秒=1,000,000纳秒）
        int milliOfSecond = nanoOfSecond / 1_000_000; // 取毫秒部分（0-999）


        // 3. 获取当前日期（年月日）
        LocalDate currentDate = LocalDate.now(DEFAULT_ZONE);


        // 4. 组合新的日期时间：当前年月日 + 原时间的时分秒毫秒
        LocalTime combinedTime = LocalTime.of(hour, minute, second, nanoOfSecond);
        LocalDateTime combinedDateTime = LocalDateTime.of(currentDate, combinedTime);


        // 5. 转换为新时间戳（毫秒）
        return combinedDateTime.atZone(DEFAULT_ZONE)
                .toInstant()
                .toEpochMilli();
    }

    /**
     * 获取指定时间戳当天0点0分0秒的时间戳（带时区处理）
     * @param timestamp 指定时间戳（毫秒，如System.currentTimeMillis()返回值）
     * @return 当天0点的时间戳（毫秒）
     */
    public Long getDayStartTimestamp(Long timestamp) {
        // 校验参数合法性
        if (timestamp == null || timestamp < 0) {
            throw new IllegalArgumentException("时间戳无效（不能为null或负数）");
        }
        // 1. 将时间戳转换为带时区的日期时间
        ZonedDateTime zonedDateTime = Instant.ofEpochMilli(timestamp)
                .atZone(DEFAULT_ZONE);

        // 2. 获取当天的起始时刻（00:00:00.000）
        // atStartOfDay(zoneId) 会自动处理时区特殊情况（如夏令时切换）
        ZonedDateTime dayStart = zonedDateTime.toLocalDate()
                .atStartOfDay(DEFAULT_ZONE);

        // 3. 转换为毫秒级时间戳
        return dayStart.toInstant().toEpochMilli();
    }
}