日期解析以及何时在 Vega Lite 中使用 utc/TimeUnits?

Date parsing and when to use utc/TimeUnits in Vega Lite?

我试图了解 Vegalite 中的日期解析是如何工作的。具体来说,我对默认时区假设和从非时区表示的字符串进行日期解析的理解有点困惑。

考虑可行的最小示例

{
  "$schema": "https://vega.github.io/schema/vega-lite/v4.json",
  "data": {
    "values": [
      {"date": "2020-10-01", "distance": 1},
      {"date": "2020-11-01", "distance": 5}
    ]
  },
  "mark": "bar",
  "encoding": {
    "x": {"field": "date", 
          "type": "temporal",  
          "timeUnit": {"unit": "yearmonthdate", "utc": true},
          "axis": {"format": "%b. %y"}
          },
    "y": {"field": "distance", "aggregate": "sum"}
  }
}

在上面的示例中,如果我省略了行(或只是 utc 标志):

"timeUnit": {"unit": "yearmonthdate", "utc": true}

日期似乎被解析为:

Wed, 30 Sep 2020 05:00:00 GMT   
Sat, 31 Oct 2020 05:00:00 GMT   

此处关于默认假设的任何指导或解释都将非常有帮助。我从给定非 ISO 字符串输入的文档中了解到,Vega 会将时间解析为本地时间 (https://vega.github.io/vega-lite/docs/timeunit.html#utc),但这里似乎不是这种情况?

谢谢

关于 Vega/Vega-Lite 如何处理日期,有两件重要的事情需要了解:

  1. 日期总是以当地时间显示,除非另有说明(例如通过将 "utc": true 传递给 timeUnit)
  2. 使用标准 javascript 日期解析来解析日期。

为什么#2 很重要?好吧,因为 Javascript 日期解析会根据输入日期的格式假定不同的时区,并且使用的时区甚至可能取决于您使用的浏览器! (在 https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse#Description 阅读比您想知道的更多的内容)

经过提炼的摘要是完整的 ISO 日期字符串(在所有浏览器上)将被解析为本地时间(我 运行 在计算机上将其设置为 PDT):

> new Date("2020-10-01T00:00:00")
  Thu Oct 01 2020 00:00:00 GMT-0700 (Pacific Daylight Time)

而部分日期或时间戳(在大多数浏览器上)将被解析为 UTC 时间:

> new Date("2020-10-01")
  Wed Sep 30 2020 17:00:00 GMT-0700 (Pacific Daylight Time)

这意味着如果将 non-ISO 时间字符串传递给 Vega-Lite,则必须在轴上使用 UTC 时间单位才能在 vega/vega-lite图表。如果不这样做,日期将以 UTC 时间解析并以本地时间显示,导致偏移等于用于查看可视化的浏览器的时区偏移。