class DateTime - json: Ruby Standard Library Documentation

# class DateTime

### Public Class Methods

json_create(object) click to toggle source

See `as_json`.

    # File json/lib/json/add/date_time.rb, line 10
    def self.json_create(object)
      args = object.values_at('y', 'm', 'd', 'H', 'M', 'S')
      of_a, of_b = object['of'].split('/')
      if of_b and of_b != '0'
        args << Rational(of_a.to_i, of_b.to_i)
      else
        args << of_a
      end
      args << object['sg']
      civil(*args)
    end

### Public Instance Methods

as_json(*) click to toggle source

Methods `DateTime#as_json` and `DateTime.json_create` may be used to serialize and deserialize a DateTime object; see Marshal.

Method `DateTime#as_json` serializes `self`, returning a 2-element hash representing `self`:

    require 'json/add/datetime'
    x = DateTime.now.as_json
    # => {"json_class"=>"DateTime", "y"=>2023, "m"=>11, "d"=>21, "sg"=>2299161.0}

Method `JSON.create` deserializes such a hash, returning a DateTime object:

    DateTime.json_create(x) # BUG? Raises Date::Error "invalid date"

    # File json/lib/json/add/date_time.rb, line 39
    def as_json(*)
      {
        JSON.create_id => self.class.name,
        'y' => year,
        'm' => month,
        'd' => day,
        'H' => hour,
        'M' => min,
        'S' => sec,
        'of' => offset.to_s,
        'sg' => start,
      }
    end

to_json(*args) click to toggle source

Returns a `JSON` string representing `self`:

    require 'json/add/datetime'
    puts DateTime.now.to_json

Output:

    {"json_class":"DateTime","y":2023,"m":11,"d":21,"sg":2299161.0}

    # File json/lib/json/add/date_time.rb, line 62
    def to_json(*args)
      as_json.to_json(*args)
    end