Utility Methods API for PubNub Ruby SDK

The methods on this page are utility methods that don't fit into other categories.

Time

This function will return a 17 digit precision Unix epoch.

timetoken = (Unix epoch time in seconds) * 10000000

Convert back and forth between current time and a timetoken:

now = Time.now
2012-11-02 14:27:11 -0700

timetoken = now.to_f * 10000000
13518916319742640

Time.at(timetoken / 10000000)
2012-11-02 14:27:11 -0700

To fetch Time you can use the following method(s) in Ruby SDK:

time(
    http_sync: http_sync,
    callback: callback
)

Parameter	Type	Required	Description
`http_sync`	Boolean	Optional	Default `false`. Method will be executed `asynchronously` and will return future, to get it's `value` you can use `value` method. If set to `true`, method will return array of envelopes (even if there's only one `envelope`). For `sync` methods `Envelope` object will be returned.
`callback`	Lambda accepting one parameter	Optional	`Callback` that will be called for each `envelope`. For `async` methods future will be returned, to retrieve `value` `Envelope` object you have to call `value` method (thread will be locked until the `value` is returned).

pubnub.time do |envelope|
    puts envelope.timetoken
end

The time() function returns a string timetoken in the following format:

13769501243685161