快速回答
第一个字符串使用您的日期格式和您的本地时区正确解析,第二个不尊重它,因此将由SimpleDateFormat
没有毫秒的默认对象解析(“yyyy-MM-dd'T'HH:mm:ss' Z' 是解析格式)并使用 UTC 时区为您提供时间部分的“偏移”。
完整答案
要完全回答您的问题,您需要深入研究 Gson 源代码。更具体地说,您必须查看DefaultDateTypeAdapter
用于解析日期的代码。您可以在链接中找到所有这些代码,但为了快速参考,我将在此处复制最相关的部分。
当您在构建器中调用它时:
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"));
}
在哪里:
enUsFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'")
和
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”。因为 has 毫秒,它会立即解析,localFormat
并使用您的时区为您提供您期望的结果。
第二个 Json 字符串:“1899-12-31T16:00:00Z”。它不会被解析,localFormat
因为没有毫秒,所以第二次机会是 enUsFormat 是相同的模式,除了语言环境。所以它会以同样的方式失败。
解析的最后机会: iso8601Format
,它没有毫秒,但是,用于构造,它也是 UTC 时区,因此它将日期解析为 UTC,而其他日期则使用您的时区解析。