如何让 JSON 中的日期格式在 ruby 与 Swift 间保持一致

Posted 2022-12-16 大熊猫侯佩

概览

用 ruby “宝藏”（Gem）Webrick 搭建的一个 Web 服务器，其通过网络向 ios 客户端返回一个 json 文件。

json 文件中包含日期字段，调试发现它在 Swift 语言中会解析失败。

这是因为 ruby 与 Swift 未对日期格式达成一致所导致的。

在本篇文章中，我们就来看看如何让它们在日期的解析上和睦相处吧。

Let’s do it! 😉

---

1. Swift 期望 JSON 中的日期格式

默认情况下，Swift 希望 json 中日期格式是一个浮点值，其表示与UTC时间 2001.1.1 00:00:00 之间相隔的秒数。

下面是一个 Swift json 文本中默认日期字段表示的示例，如您所见这是一个浮点值：

let jsonString = "\\"date\\":685626911.5754602"

2. ruby 写入 JSON 中的日期格式

在服务器端，我们是这样处理日期格式的（仅限本例中）：

[1] pry(main)> require 'json'
=> true
[2] pry(main)> dict = 
=> 
[3] pry(main)> dict["date"] = Time.now
=> 2022-09-23 15:53:02.177474 +0800
[4] pry(main)> dict
=> "date"=>2022-09-23 15:53:02.177474 +0800
[5] pry(main)> JSON.dump(dict)
=> "\\"date\\":\\"2022-09-23 15:53:02 +0800\\""

可以发现，ruby实际向 json日期字段赋予的是一个表示日期的字符串：“2022-09-23 15:53:02.177474 +0800”。

3. 调整为Swift的日期格式

第一种方法是 ruby 服务器端在写入日期 json 字段时，使用 Swift 默认的格式：

[12] pry(main)> ref_date = Time.mktime(2001,1,1,0,0,0)
=> 2001-01-01 00:00:00 +0800
[13] pry(main)> now = Time.now
=> 2022-09-23 16:05:56.284837 +0800
[14] pry(main)> offset = now.to_f - ref_date.to_f
=> 685641956.284837

细心的小伙伴可能会发现：上面创建 ref_date 并不是 UTC 日期，而是一个本地日期，这是因为后面会减去一个相同时区的本地日期，所以产生的误差被抵消掉了。

4. Swift中更改默认的日期格式

第二种方法是，Swift 在解析 JSON 格式时与 ruby 协商为一致的 iso8601 格式。

首先是 ruby 中的调整：

[1] pry(main)> require 'date'
=> true
[2] pry(main)> now = DateTime.now.iso8601
=> "2022-09-23T16:09:12+08:00"

接着，是 Swift 中的调整：

struct Foo: Codable 
    var date: Date


let decoder = JSONDecoder()
decoder.dateDecodingStrategy = .iso8601
let foo = try decoder.decode(Foo.self, from: data)

5. 总结

在本篇博文中，我们讨论了如何让 ruby 和 Swift 语言对于 JSON 文件中的日期格式达成一致，其实只要两者事先协调好，用什么日期格式都无所谓了，区别也只是实现上的难易罢了。

小伙伴们觉得呢？

感谢观赏，再会！😎