在项目开发中经常会遇到时间参数，比如开始时间结束时间；但是往往会出现一个问题那就是时间的格式问题，当前后端格式不一致的时候就导致参数无法接收。这就要写一个兼容很多格式的转换器。那有没有更简便的方式呢，例如我们通过间隔来计算开始与结束时间，只要传一个简单的代码码就可以呢。
修饰符时间精度
传值方式
修饰符和时间精度配合再加上单位间隔数量
时间传参DTO类
import java.util.Date;import io.swagger.v3.oas.annotations.media.Schema;import lombok.Getter;import lombok.Setter;import lombok.experimental.Accessors;@Schema(name = "时间区段参数", description = "时间区段参数DTO")@Getter@Setter@Accessors(chain = true)public class DateSegmentDTO {@Schema(description = "开始时间")private Date start;@Schema(description = "结束时间")private Date end;@Schema(description = "时间区段代码")private String stepCode;}
时间区间工具类
时间区间是[start,end) 包含开始不包含结束，条件应为 >= start , < end
import java.text.DateFormat;import java.text.ParseException;import java.text.SimpleDateFormat;import java.util.ArrayList;import java.util.Calendar;import java.util.Date;import java.util.List;import mons.lang3.Validate;import org.springframework.util.Assert;import com.qjwy.system.dto.DateSegmentDTO;/*** 时间区间工具* * 本工具旨在降低时间区间传参的复杂度，通过三个参数控制开始时间和结束时间的参数* * Date start; Date end; String stepCode;* * * @author:三石* @since:1.0*/public class DurationUtils {private DurationUtils() {}// 所有修饰和精度的组合private static final List<String> COMBINATION = new ArrayList<String>();static {for (MODIFY_TYPE modifyType : MODIFY_TYPE.values()) {for (DURATION_TYPE durationType : DURATION_TYPE.values()) {COMBINATION.add(modifyType.name() + durationType.name());}}}/*** 注入时间* * @param date 指定的时间* @param segment 时间参数封装*/public static void injectDateTime(Date date, DateSegmentDTO segment) {Date start = segment.getStart();Date end = segment.getEnd();String stepCode = segment.getStepCode();if (start == null && end == null) {Assert.notNull(stepCode, "时间区间参数不能同时为null");String expression = stepCode.substring(0, 2);Assert.isTrue(COMBINATION.contains(expression), "不支持的组合：" + expression + "，目前可支持的组合" + COMBINATION);String[] codes = expression.split("");MODIFY_TYPE modifyType = MODIFY_TYPE.valueOf(codes[0]);DURATION_TYPE durationType = DURATION_TYPE.valueOf(codes[1]);Date[] se = modifyType.getRuleFunction().calc(//date, //durationType.getField(), //stepCode.length() >= 3 ? Integer.parseInt(stepCode.substring(2)) : 0, //durationType.getSmallerFields()//);segment.setStart(se[0]).setEnd(se[1]);}}/*** 时间区间类型*/enum DURATION_TYPE {S("毫秒", Calendar.MILLISECOND, new int[] {}), //s("秒", Calendar.SECOND, new int[] {Calendar.MILLISECOND }), //m("分", Calendar.MINUTE, new int[] {Calendar.MILLISECOND, Calendar.SECOND }), //H("小时", Calendar.HOUR_OF_DAY, new int[] {Calendar.MILLISECOND, Calendar.SECOND, Calendar.MINUTE }), //d("日", Calendar.DAY_OF_MONTH, new int[] {Calendar.MILLISECOND, Calendar.SECOND, Calendar.MINUTE, Calendar.HOUR_OF_DAY }), //M("月", Calendar.MONTH, new int[] {Calendar.MILLISECOND, Calendar.SECOND, Calendar.MINUTE, Calendar.HOUR_OF_DAY, Calendar.DAY_OF_MONTH }), //y("年", Calendar.YEAR, new int[] {Calendar.MILLISECOND, Calendar.SECOND, Calendar.MINUTE, Calendar.HOUR_OF_DAY, Calendar.DAY_OF_MONTH, Calendar.MONTH }), //W("周", Calendar.WEEK_OF_YEAR, new int[] {Calendar.MILLISECOND, Calendar.SECOND, Calendar.MINUTE, Calendar.HOUR_OF_DAY, Calendar.DAY_OF_WEEK });// 精度private String accuracy;// 当前时间域private int field;// 更小的单位的时间域private int[] smallerFields;private DURATION_TYPE(String accuracy, int field, int[] smallerFields) {this.accuracy = accuracy;this.field = field;this.smallerFields = smallerFields;}public String getAccuracy() {return accuracy;}public int getField() {return field;}public int[] getSmallerFields() {return smallerFields;}}/*** 时间区间修饰类型*/enum MODIFY_TYPE {B("before", "前N个，不包含当前", //(date, field, step, smallerunits) -> {Date start = date;Date end = date;start = add(start, field, -step);Calendar instance = Calendar.getInstance();for (int unit : smallerunits) {int minimum = instance.getMinimum(unit);// 设置周一为每周中第一天if (unit == Calendar.DAY_OF_WEEK) {minimum = Calendar.MONDAY;}start = set(start, unit, minimum);end = set(end, unit, minimum);}return new Date[] {start, end };}//), //P("past", "过去N个，包含当前", //(date, field, step, smallerunits) -> {Date start = date;Date end = date;start = add(start, field, -step);return new Date[] {start, end };}//), //C("current", "当前", //(date, field, step, smallerunits) -> {Date start = date;Date end = date;Calendar instance = Calendar.getInstance();for (int unit : smallerunits) {int minimum = instance.getMinimum(unit);// 设置周一为每周中第一天if (unit == Calendar.DAY_OF_WEEK) {minimum = Calendar.MONDAY;}start = set(start, unit, minimum);}return new Date[] {start, end };}//);// 含义private String meaning;// 描述private String desc;// 计算规则private RuleFunction ruleFunction;private MODIFY_TYPE(String meaning, String desc, RuleFunction ruleFunction) {this.meaning = meaning;this.desc = desc;this.ruleFunction = ruleFunction;}public String getMeaning() {return meaning;}public String getDesc() {return desc;}public RuleFunction getRuleFunction() {return ruleFunction;}}/*** 时间规则函数*/@FunctionalInterfaceprivate interface RuleFunction {Date[] calc(Date date, int field, int step, int[] smallerunits);}/*** 验证date不为null* * @param date 时间*/private static void validateDateNotNull(final Date date) {Validate.notNull(date, "date");}/*** 将指定字段设置为返回新对象的日期。使用非宽松解释* * * <p>* 不会改变原来的 {@code Date}* </p>** @param date日期，不为空* @param calendarField 要添加到其中的日历字段* @param amount 要加的量* @return 新的{@code Date}与添加的时间量* @throws IllegalArgumentException 当date为null时*/private static Date set(final Date date, final int calendarField, final int amount) {validateDateNotNull(date);// getInstance()返回一个新对象，因此这个方法是线程安全的final Calendar c = Calendar.getInstance();// 设置一周的开始为周一c.setFirstDayOfWeek(Calendar.MONDAY);c.setLenient(false);c.setTime(date);c.set(calendarField, amount);return c.getTime();}/*** 新创建一个日期对象，并设定日期* <p>* 不会改变原来的 {@code Date}* </p>* * @param date日期，不为空* @param calendarField 要添加到其中的日历字段* @param amount 要加的量，可以是负的* @return 新的{@code Date}与添加的时间量* @throws NullPointerException 当date为null时*/private static Date add(final Date date, final int calendarField, final int amount) {validateDateNotNull(date);final Calendar c = Calendar.getInstance();// 设置一周的开始为周一c.setFirstDayOfWeek(Calendar.MONDAY);c.setTime(date);c.add(calendarField, amount);return c.getTime();}}
测试
public static void main(String[] args) throws ParseException {DateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss SSS");Date date = format.parse("-07-16 09:30:25 321");DateSegmentDTO dto1 = new DateSegmentDTO().setStepCode("Py1");DurationUtils.injectDateTime(date, dto1);System.out.println("过去1年：Py1");System.out.println(format.format(dto1.getStart()));System.out.println(format.format(dto1.getEnd()));DateSegmentDTO dto2 = new DateSegmentDTO().setStepCode("By2");DurationUtils.injectDateTime(date, dto2);System.out.println("前两年：By2");System.out.println(format.format(dto2.getStart()));System.out.println(format.format(dto2.getEnd()));DateSegmentDTO dto3 = new DateSegmentDTO().setStepCode("Cy");DurationUtils.injectDateTime(date, dto3);System.out.println("当年：Cy");System.out.println(format.format(dto3.getStart()));System.out.println(format.format(dto3.getEnd()));DateSegmentDTO dto4 = new DateSegmentDTO().setStepCode("PW1");DurationUtils.injectDateTime(date, dto4);System.out.println("过去1周：PW1");System.out.println(format.format(dto4.getStart()));System.out.println(format.format(dto4.getEnd()));DateSegmentDTO dto5 = new DateSegmentDTO().setStepCode("Bd7");DurationUtils.injectDateTime(date, dto5);System.out.println("前7天：Bd7");System.out.println(format.format(dto5.getStart()));System.out.println(format.format(dto5.getEnd()));}
测试结果
过去1年：Py1-07-16 09:30:25 321-07-16 09:30:25 321前两年：By2-01-01 00:00:00 000-01-01 00:00:00 000当年：Cy-01-01 00:00:00 000-07-16 09:30:25 321过去1周：PW1-07-09 09:30:25 321-07-16 09:30:25 321前7天：Bd7-07-09 00:00:00 000-07-16 00:00:00 000
java时间工具类；获取当前 过去N个单位 前N个单位（不包含当前）年月日时分秒毫秒的开始与结束时间
