前后端_时间参数传递及格式化

前言

在项目开发过程中，时间参数的传递与格式化处理是极为常见且关键的环节。不同的请求方式（如 GET、POST 等）、不同的参数传递形式（Query 参数、Request Body 参数等），以及不同的响应需求，都对时间参数的处理提出了多样化要求。为了让开发者能清晰、高效地掌握各类场景下时间参数的处理方法，本文将从基础到进阶，详细介绍时间传参的各类场景、处理方式以及自定义格式化的实现。

1. 时间传参基础场景

1.1 Query 时间传参

Query 时间传参适用于 GET 请求或 POST 的 form-data 请求，常应用于页面查询等场景，用于传递单个或多个时间条件。

1.1.1 后端接收方式

后端接收时间参数时，需在对应的 VO 类属性上添加 SpringMVC 的 @DateTimeFormat 注解，并指定匹配的时间格式，示例如下：

@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime beginTime;

// UserPageReqVO.java
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime[] createTime;

1.1.2 前端传递方式

前端传递时间参数时，要使用与后端注解中指定格式一致的字符串格式，即 yyyy-MM-dd HH:mm:ss。

• 单个时间传参示例：

  // 传递 beginTime 或 endTime 参数
  {
       
       
    beginTime: '2023-10-01 00:00:00',
    endTime: '2023-10-31 23:59:59'
  }
  

• 多个时间传参示例：

  // 传递时间范围数组
  {
       
       
    createTime: ['2023-10-01 00:00:00', '2023-10-31 23:59:59']
  }
  

请求示例如下：

# GET请求
http://127.0.0.1:9998/demo/date2? createTime[0]=2023-10-31 23:59:59&createTime[1]=2025-10-31 23:59: