Apache IoTDB 2.0.6的FORMAT函数是否必须使用Java String.format语法？

问题场景 #

使用Apache IoTDB 2.0.6表模型时，尝试用FORMAT函数将TIMESTAMP列转为字符串，遇到格式说明符兼容性问题：

1. 建表与插入数据：

CREATE TABLE test (value INT32 Field);
INSERT INTO test(`time`, value) VALUES (2024-11-30T09:30:00, 1);

2. 使用带%1$t前缀的格式符可成功执行：

SELECT format('%1\$tY-%1\$tm-%1\$td %1\$tH:%1\$tM:%1\$tS', `time`) from test;

返回结果符合预期：

+-------------------+
| _col0|
+-------------------+
|2024-11-30 09:30:00|
+-------------------+
Total line number = 1

3. 使用简化格式符%Y-%m-%d %H:%M:%S时触发语法错误：

SELECT format('%Y-%m-%d %H:%M:%S', `time`) from test;

错误信息：

Msg: org.apache.iotdb.jdbc.IoTDBSQLException: 301: Conversion = 'Y'

回答 #

是的，Apache IoTDB 2.0.6的FORMAT函数严格遵循Java String.format()的语法规则，处理TIMESTAMP类型时必须使用带%n$t前缀的格式说明符：

• %n$用于指定参数位置（这里仅传入一个时间参数，所以用%1$）
• t是时间类型转换的标识，后续的Y/m/d等才是具体的时间分量格式符

你尝试的%Y这类简化写法，在Java格式化规则中不属于时间转换的合法占位符——%Y本身是用于格式化十进制整数的转换符，无法匹配TIMESTAMP类型，因此IoTDB会抛出转换错误。

如果觉得%1$tY这类写法过于繁琐，IoTDB 2.x版本也支持to_char函数来更直观地格式化时间，示例：

SELECT to_char(`time`, 'yyyy-MM-dd HH:mm:ss') from test;

该函数的格式符采用更通用的yyyy/MM风格，无需前缀，使用起来更简洁。

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