java - Gson 中的 DateFormat 模式 "yyyy-MM-dd' T'HH :mm:ss. SSS'Z'"

Question

我有如下两个字段(注意第一个字段有毫秒部分):

{
  "updateTime":"2011-11-02T02:50:12.208Z",
  "deliverTime"："1899-12-31T16:00:00Z"
}

我想用Gson将Json字符串反序列化为一个对象，所以得到一个Gson实例:

GsonBuilder gb = new GsonBuilder();
gb.setDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'");
gson = gb.create();

第一个字段被反序列化为 Java 日期类型:2011-11-02 02:50:12.208(看起来忽略了时区部分 - “Z”，这是我的预期)。然而，第二个字段被反序列化为1900-01-01 00:00:00(我住在中国，这里是+8 GMT)，似乎时区部分-'Z'扮演了一个参与反序列化。

为什么第二个字段使用时区部分？这不是我所期望的。

Answer 1

快速回答

第一个字符串使用您的日期格式和本地时区正确解析，第二个字符串不遵守它，因此将由默认的 SimpleDateFormat 对象解析，该对象没有毫秒(“yyyy-MM -dd'T'HH:mm:ss'Z' 是解析格式)并使用 UTC 时区为您提供时间部分的“转换”。

完整答案

要完整回答您的问题，您需要深入研究 Gson 源代码。更具体地说，您必须查看用于解析日期的 DefaultDateTypeAdapter 代码。您可以在 link 找到所有这些代码，但为了快速引用，我将在此处复制大部分相关部分。

当您在构建器中调用它时:

gb.setDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'");

您正在以这种方式初始化 DefaultDateTypeAdapter:

DefaultDateTypeAdapter(DateFormat enUsFormat, DateFormat localFormat) {
   this.enUsFormat = enUsFormat;
   this.localFormat = localFormat;
   this.iso8601Format = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'", Locale.US);
   this.iso8601Format.setTimeZone(TimeZone.getTimeZone("UTC"));
}

哪里:

1. enUsFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'") 和
2. localFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'", Locale.US)

因为您在构建器中传递了字符串。

请注意 Locale.US 不是时区，iso8601Format 与 enUsFormat 相同，没有毫秒但有 UTC 时区。

解析发生在 deserializeToDate 方法中:

 private Date deserializeToDate(JsonElement json) {
    synchronized (localFormat) {
      try {
        return localFormat.parse(json.getAsString());
      } catch (ParseException ignored) {
      }
      try {
        return enUsFormat.parse(json.getAsString());
      } catch (ParseException ignored) {
      }
      try {
        return iso8601Format.parse(json.getAsString());
      } catch (ParseException e) {
        throw new JsonSyntaxException(json.getAsString(), e);
      }
    }
  }

瀑布方法中使用了所有三种日期格式。

第一个 Json 字符串:“2011-11-02T02:50:12.208Z”。它会立即被 localFormat 解析，因为它有毫秒数，并为您提供使用您的时区所期望的结果。

第二个 Json 字符串:“1899-12-31T16:00:00Z”。它不会被 localFormat 解析，因为没有毫秒，所以第二次机会是 enUsFormat，它是 相同的模式，除了语言环境。所以它会以同样的方式失败。

最后一次解析:iso8601Format，它会，它没有毫秒，但是，为了构造，它也是一个UTC时区，所以它会解析日期作为 UTC，而其他人使用您的时区进行解析。