Java 结合 PostgreSQL 实现节气与季节检索实战

核心查询逻辑

判断某日期属于哪个节气，关键在于找到该日期落在哪两个节气之间。利用 PostgreSQL 的窗口函数 LEAD 可以方便地获取下一个节气的开始时间。

WITH ordered_terms AS (
    SELECT solar_term, solar_date, 
           LEAD(solar_date) OVER (ORDER BY solar_date) AS next_date 
    FROM biz_solarterms
)
SELECT solar_term, solar_date, next_date 
FROM ordered_terms 
WHERE to_date('2025-09-10','YYYY-MM-DD') >= solar_date 
  AND (to_date('2025-09-10','YYYY-MM-DD') < next_date OR next_date IS NULL);

执行结果会返回对应的节气名称及起止时间，例如 2025-09-10 对应'白露'。

Java 实现

在应用层，我们使用 Java 调用上述 SQL，并将节气映射为季节。

数据访问层

这里使用 MyBatis 封装查询逻辑。注意 XML 中特殊字符的处理。

public interface SolarTermsMapper extends BaseMapper<SolarTerms> {
    static final String FIND_SOLARTERMS_BYDATE = "<script>" +
        " WITH ordered_terms AS ( SELECT solar_term, solar_date,LEAD(solar_date) OVER (ORDER BY solar_date) AS next_date " +
        " FROM biz_solarterms ) SELECT solar_term, solar_date, next_date FROM ordered_terms " +
        " <![CDATA[ WHERE to_date(#{queryDate},'YYYY-MM-DD') >= solar_date AND (to_date(#{queryDate},'YYYY-MM-DD') < next_date OR next_date IS NULL) ]]> " +
        "</script>";

    @Select(FIND_SOLARTERMS_BYDATE)
    SolarTerms findSolarTermsByDate(@Param("queryDate")String queryDate);
}

业务逻辑层

获取节气后，根据预设规则反推季节。Switch 语句清晰直观。

@Override
public String getSeason(String solarTerm) {
    switch (solarTerm) {
        case "立春": case "雨水": case "惊蛰": case "春分": case "清明": case "谷雨":
            return "春季";
        case "立夏": case "小满": case "芒种": case "夏至": case "小暑": case "大暑":
            return "夏季";
        case "立秋": case "处暑": case "白露": case "秋分": case "寒露": case "霜降":
            return "秋季";
        case "立冬": case "小雪": case "大雪": case "冬至": case "小寒": case "大寒":
            return "冬季";
        default:
            return "未知";
    }
}

测试验证

通过 JUnit 模拟不同日期的查询，确保逻辑闭环。

@Test
public void testGetSolar() {
    SolarTerms solarTerms = solarTermsService.findSolarTermsByDate("2025-07-10");
    System.out.println(solarTerms.getSolarTerm() + " -> " + solarTermsService.getSeason(solarTerms.getSolarTerm()));
    
    solarTerms = solarTermsService.findSolarTermsByDate("2025-10-08");
    System.out.println(solarTerms.getSolarTerm() + " -> " + solarTermsService.getSeason(solarTerms.getSolarTerm()));
    
    solarTerms = solarTermsService.findSolarTermsByDate("2025-11-23");
    System.out.println(solarTerms.getSolarTerm() + " -> " + solarTermsService.getSeason(solarTerms.getSolarTerm()));
}

控制台输出应显示正确的节气与季节对应关系，验证了从日期到节气再到季节的完整链路是准确的。

总结

本方案通过 PostgreSQL 的窗口函数高效解决日期区间匹配问题，结合 Java 的业务逻辑实现文化时间的程序化表达。系统轻量且准确，适用于日历服务、农业应用等多种场景。后续可进一步扩展可视化或自定义查询功能。