Spring Data JPA按月份参数查询Oracle时间戳数据的正确方法

通过以下Spring Boot接口接收UI传入的整数月份参数：

@GetMapping("/{Monthnumber}")
public List<FunctionList> getByMonth(@PathVariable("MonthNumber") int month)

需要在Spring Data JPA的Repository中编写原生查询，从Oracle数据库的时间戳列（示例格式：22-FEB-22 11.00.00.00000000 AM）筛选对应月份的数据。此前尝试的查询写法无法正确执行：

@Query("SELECT * FROM Table_name WHERE month(timestamp_date) = ?1)
List<Functionlist> getByMonth(int month number)

核心问题梳理 #

你的写法存在三个关键错误：

• Oracle数据库没有month()函数，这是MySQL等数据库的语法，Oracle需使用专属日期处理函数
• JPA原生查询必须显式声明nativeQuery = true，否则会被当作JPQL语法解析
• 代码存在语法疏漏：括号未闭合、方法参数写法错误、实体类名大小写不匹配（Functionlist应为FunctionList）

正确代码实现 #

以下两种方式均可实现需求，任选其一即可：

方式1：使用EXTRACT函数提取月份数字

@Query(value = "SELECT * FROM Table_name WHERE EXTRACT(MONTH FROM timestamp_date) = ?1", nativeQuery = true)
List<FunctionList> getByMonth(int month);

EXTRACT(MONTH FROM 列名)会直接返回1-12的整数月份，与传入的参数类型完全匹配，无需额外类型转换。

方式2：使用TO_CHAR格式化后转数字匹配

@Query(value = "SELECT * FROM Table_name WHERE TO_NUMBER(TO_CHAR(timestamp_date, 'MM')) = ?1", nativeQuery = true)
List<FunctionList> getByMonth(int month);

TO_CHAR(timestamp_date, 'MM')会将月份转为两位字符串（如02代表二月），再通过TO_NUMBER转为整数后与参数匹配。

额外注意事项 #

• 确保传入的month参数是1-12之间的有效整数，避免无效值导致无结果返回
• 若时间戳列存在NULL值，查询会自动忽略这些行，无需额外处理
• 如需同时匹配年份，可在查询条件中添加EXTRACT(YEAR FROM timestamp_date) = ?2，并同步修改方法参数增加年份参数

内容的提问来源于stack exchange，提问作者Newbie learner