Vega-Lite v5版本中日期与时间列的正确编码方式是什么？

v5版本对时间格式的支持范围和v4有明确调整，你遇到的datetime对象静默失效是版本迭代带来的规则变化，合法的编码方式一共3种，对应不同使用场景：

• Unix时间戳（毫秒级）
  即从1970-01-01 00:00:00 UTC开始计算的毫秒数值，这是兼容性最好、完全不会出现解析歧义的格式，Vega-Lite可以自动识别为时间类型，不需要额外配置解析规则，适合对时区一致性要求高的场景。
• ISO 8601标准时间字符串
  格式类似"2006-01-01"、"2006-01-01T12:30:00+08:00"、"2006-01-01T00:00:00Z"，这是v5官方最推荐的字符串类时间格式，解析稳定性远高于自定义格式的时间字符串。
• 通过内置表达式转换生成的时间对象
  如果你的原始数据是拆分存储的年、月、日、时、分、秒字段，不需要提前拼接成ISO字符串，可以直接在Vega-Lite的transform阶段用内置datetime表达式生成合法时间值，示例代码：

  "transform": [
    {"calculate": "datetime(datum.year, datum.month_num - 1, datum.day, datum.hour, datum.minute)", "as": "formatted_time"}
  ]
  

  注意表达式里的月份参数是从0开始计数的（0代表1月，11代表12月），如果原始数据里的月份是从1开始计数的数字，要手动减1；如果是"jan""feb"这类字符串缩写，提前做映射转成对应数字即可。

关键避坑：v4版本允许在数据源行级数据中传入{"year": 2006, "month": "jan", "date": 1}这类datetime定义对象，但v5已经完全收窄了该格式的使用范围——这类对象现在只能用于配置项，比如设置轴的固定刻度值、参考线位置、筛选器的固定时间阈值，不能再作为数据集里的字段值传入，传入后不会抛出解析错误，但会被判定为非法值直接跳过，也就是你遇到的静默失效问题。

额外建议：不管使用上述哪种时间格式，在encoding通道编码字段时，最好显式指定字段类型为时间类型，写法可以是字段名后加:T简写，也可以在配置里写"type": "temporal"，避免自动类型推断把时间值识别成字符串或者数字，导致图表渲染异常。

内容的提问来源于stack exchange，提问作者CL-USER