Snowflake Java UDTF中DATE转java.sql.Date时区不符问题咨询

问题本质 #

Snowflake的DATE类型是无时区属性的纯日期值，当映射到Java的java.sql.Date时，JDBC驱动默认将该日期解析为UTC时区的午夜时间（而非账户配置的America/New_York时区）。原因在于：

• java.sql.Date内部以UTC时间戳存储，JDBC驱动的默认转换逻辑未将Snowflake账户/会话时区应用到DATE类型的映射中；
• 文档中提到的“UDTF环境继承数据库时区”仅针对带时区的时间类型（如TIMESTAMP_TZ、TIMESTAMP_LTZ），不适用于无时区的DATE类型。

解决方案（无需修改UDTF参数类型） #

方案1：SQL层显式转换（局部生效）

在调用UDTF前，将DATE列转换为纽约时区的午夜时间，确保驱动映射出正确的java.sql.Date值：

-- 方式1：拼接时间后转时区再转DATE
SELECT YOUR_UDTF(TO_DATE(CONVERT_TIMEZONE('America/New_York', YOUR_DATE_COL || ' 00:00:00')))
FROM YOUR_TABLE;

-- 方式2：构造带时区的时间戳再转DATE
SELECT YOUR_UDTF(TO_DATE(TIMESTAMP_TZ_FROM_PARTS(
    YEAR(YOUR_DATE_COL), 
    MONTH(YOUR_DATE_COL), 
    DAY(YOUR_DATE_COL), 
    0, 0, 0, 0, 
    'America/New_York'
)))
FROM YOUR_TABLE;

方案2：JDBC连接参数配置（全局生效）

在Snowflake JDBC连接URL中添加useSessionTimezone=true参数，让驱动在转换DATE类型时使用账户/会话时区而非UTC：

jdbc:snowflake://<account>.snowflakecomputing.com/?db=<database>&schema=<schema>&warehouse=<warehouse>&useSessionTimezone=true

注意：该配置会影响所有DATE类型的转换，需评估全局业务影响。

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