Class: BSON::Timestamp

Inherits:
Object
  • Object
show all
Includes:
JSON
Defined in:
lib/bson/timestamp.rb

Overview

Represents a timestamp type, which is predominately used for sharding.

See Also:

Since:

  • 2.0.0

Constant Summary collapse

BSON_TYPE =

A timestamp is type 0x11 in the BSON spec.

Since:

  • 2.0.0

17.chr.force_encoding(BINARY).freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from JSON

#to_json

Constructor Details

#initialize(seconds, increment) ⇒ Timestamp

Instantiate the new timestamp.

Examples:

Instantiate the timestamp.

BSON::Timestamp.new(5, 30)

Parameters:

  • seconds (Integer) —

    The number of seconds.

  • increment (Integer) —

    The increment value.

Since:

  • 2.0.0



76
77
78
 
# File 'lib/bson/timestamp.rb', line 76

def initialize(seconds, increment)
  @seconds, @increment = seconds, increment
end

Instance Attribute Details

#increment ⇒ Object

Since:

  • 2.0.0



38
 
# File 'lib/bson/timestamp.rb', line 38

attr_reader :seconds, :increment

#seconds ⇒ Integer

Returns The number of seconds.

Returns:

  • (Integer) —

    The number of seconds.

Since:

  • 2.0.0



38
39
40
 
# File 'lib/bson/timestamp.rb', line 38

def seconds
  @seconds
end

Class Method Details

.from_bson(buffer) ⇒ Timestamp

Deserialize timestamp from BSON.

Parameters:

Returns:

See Also:

Since:

  • 2.0.0



104
105
106
107
108
 
# File 'lib/bson/timestamp.rb', line 104

def self.from_bson(buffer)
  increment = buffer.get_int32
  seconds = buffer.get_int32
  new(seconds, increment)
end

Instance Method Details

#==(other) ⇒ true, false

Determine if this timestamp is equal to another object.

Examples:

Check the timestamp equality.

timestamp == other

Parameters:

  • other (Object) —

    The object to compare against.

Returns:

  • (true, false) —

    If the objects are equal.

Since:

  • 2.0.0



50
51
52
53
 
# File 'lib/bson/timestamp.rb', line 50

def ==(other)
  return false unless other.is_a?(Timestamp)
  seconds == other.seconds && increment == other.increment
end

#as_json(*args) ⇒ Hash

Get the timestamp as JSON hash data.

Examples:

Get the timestamp as a JSON hash.

timestamp.as_json

Returns:

  • (Hash) —

    The timestamp as a JSON hash.

Since:

  • 2.0.0



63
64
65
 
# File 'lib/bson/timestamp.rb', line 63

def as_json(*args)
  { "t" => seconds, "i" => increment }
end

#to_bson(buffer = ByteBuffer.new, validating_keys = Config.validating_keys?) ⇒ String

Get the timestamp as its encoded raw BSON bytes.

Examples:

Get the timestamp as BSON.

timestamp.to_bson

Returns:

  • (String) —

    The raw BSON bytes.

See Also:

Since:

  • 2.0.0



90
91
92
93
 
# File 'lib/bson/timestamp.rb', line 90

def to_bson(buffer = ByteBuffer.new, validating_keys = Config.validating_keys?)
  buffer.put_int32(increment)
  buffer.put_int32(seconds)
end