Ruby里Time#to_json结果的两种格式
晚上在接入方的提醒下,注意到了一个之前没在意的问题:OPEN API中所有返回的json时间格式都是2017-08-25T21:30:28.388Z这样的。
“这个不好解析”,接入方如是说。
“大概是没法一行解析吧”,同事这么讲。
快醒醒,他们用的可是java,java怎么可能只写一行,分分钟给你写个大项目出来!
public static Date stringToDate(String dateStr) {
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'");
Date date = null;
try {
date = format.parse(dateStr);
} catch (Exception e) {
e.printStackTrace();
Log.e(Constants.LOG_TAG_C, "String to date error : " + e, e);
return date;
好吧,回归正题,我这才意识到为什么这个时间的格式是这样子的。
我尝试在repl查看结果:
2.4.1 :011 > PlayRecord.last.created_at.to_json
=> "\"2017-08-25T21:30:28.388Z\""
2.4.1 :012 > PlayRecord.last.created_at.as_json
=> "2017-08-25T21:30:28.388Z"
2.4.1 :013 > PlayRecord.last.created_at.to_s
=> "2017-08-25 21:30:28 UTC"
2.4.1 :014 > PlayRecord.last.created_at.class
=> Time
2.4.1 :015 > Time.now.to_s
=> "2017-08-25 21:39:50 +0800"
2.4.1 :016 > Time.now.to_json
=> "\"2017-08-25T21:39:56.335+08:00\""
Time对象调用to_json函数得到得到的结果不一样,调用to_s的结果也不一样,to_json底层甚至没有按照我设想的调用to_s方法。
第一个反应ActiveRecord以及ActiveSupport给Time类增加了内容,就在github的茫茫多源码里找,未果。
我要怎么知道具体的to_json函数究竟写了点什么呢?
Google “how to get source code ruby”
通过 method方法拿到具体某个方法对象,调用source_location可以拿到原文件的位置。
想再偷懒一点还可以直接打印到屏幕上
require 'method_source'
Set.instance_method(:merge).source.display
有了这两个内省的方法,就可以很方便的找到最终的位置了
/active_support/core_ext/object/json.rb 这个文件给Time类加了as_json的函数
(实际上,grape api 在最后返回的时候并不是简单的调用JSON.dump(data),而是调用了to_json来拿到最后的json字符串,但是to_json实际调用的是ActiveSupport::JSON.encode(self, options),最后一路找下去实际上就是
stringify jsonify value.as_json(options.dup),本质还是在调用as_json):
class Time
def as_json(options = nil) #:nodoc:
if ActiveSupport::JSON::Encoding.use_standard_json_time_format
xmlschema(ActiveSupport::JSON::Encoding.time_precision)
%(#{strftime("%Y/%m/%d %H:%M:%S")} #{formatted_offset(false)})
具体在Time的xmlschema函数里会根据是否是utc时间来给出不同的格式,这里会直接format,并不会调用to_s
def xmlschema(fraction_digits=0)
fraction_digits = fraction_digits.to_i
s = strftime("%FT%T")
if fraction_digits > 0
s << strftime(".%#{fraction_digits}N")
s << (utc? ? 'Z' : strftime("%:z"))
到了这里就发现,分叉的地方其实是utc?这个函数,当我们继续使用source_location的时候得到了一个nil,但是调用却是没问题的。
2.4.1 :003 > PlayRecord.last.created_at.utc?
=> true
2.4.1 :004 > Time.now.utc?
=> false
答案终于揭晓了,从ActiveRecord从数据库读取到的时间戳是UTC的,而本地Time.now得到的时间是有时区的。s << (utc? ? 'Z' : strftime("%:z"))这一样代码决定了最后出来的格式。
自然顺着这个思路,我们去看to_s这个方法,同样也是找不到源代码,找不到源代码的原因是因为是由ruby解释器实现的,在 http:// ruby-doc.org 上可以看到具体的源代码,同样根据是否是UTC时间做了判断:
static VALUE
time_to_s(VALUE time)
struct time_object *tobj;
GetTimeval(time, tobj);
if (TIME_UTC_P(tobj))
return strftimev("%Y-%m-%d %H:%M:%S UTC", time, rb_usascii_encoding());
return strftimev("%Y-%m-%d %H:%M:%S %z", time, rb_usascii_encoding());
那么问题来了,既然是本地,在jruby下会怎样呢。
我特意去找了jruby的源码(/core/src/main/java/org/jruby/RubyTime.java):
private final static DateTimeFormatter TO_S_FORMATTER = DateTimeFormat.forPattern("yyyy-MM-dd HH:mm:ss Z").withLocale(Locale.ENGLISH);
private final static DateTimeFormatter TO_S_UTC_FORMATTER = DateTimeFormat.forPattern("yyyy-MM-dd HH:mm:ss 'UTC'").withLocale(Locale.ENGLISH);
@Override
@JRubyMethod(name = {"to_s", "inspect"})
public IRubyObject to_s() {
return inspectCommon(TO_S_FORMATTER, TO_S_UTC_FORMATTER);
private IRubyObject inspectCommon(DateTimeFormatter formatter, DateTimeFormatter utcFormatter) {
DateTimeFormatter simpleDateFormat;
if (dt.getZone() == DateTimeZone.UTC) {
simpleDateFormat = utcFormatter;
} else {
simpleDateFormat = formatter;
String result = simpleDateFormat.print(dt);
if (isTzRelative) {
// display format needs to invert the UTC offset if this object was
// created with a specific offset in the 7-arg form of #new
DateTimeZone dtz = dt.getZone();
int offset = dtz.toTimeZone().getOffset(dt.getMillis());
DateTimeZone invertedDTZ = DateTimeZone.forOffsetMillis(offset);
DateTime invertedDT = dt.withZone(invertedDTZ);
result = simpleDateFormat.print(invertedDT);
return RubyString.newString(getRuntime(), result, USASCIIEncoding.INSTANCE);