Time And Date Ruby API

An access key and a secret key is required to use the API. If you are not already a Time and Date API user, please see our API offers to get a free 3 month trial. For more information, see our API Services page.

Get started

Add the gem as a dependency in the Gemfile:

gem 'libtad'

Require the gem in your source code:

require 'libtad'

Setup the client with your access key and secret key:

client = ::LibTAD::Client.new(access_key: 'access_key', secret_key: 'secret_key')

Astronomy Service

Get astronomical events for a place on a date by textual ID:

place = "usa/anchorage"
date = ::LibTAD::TADTime::TADDateTime(year: 2015, month: 1, day: 1)
client = ::LibTAD::Client.new(access_key: 'access_key', secret_key: 'secret_key')
astro_events = client.get_astro_events(:sun, place_id: place, start_date: date)

Get astronomical events for a place between two dates by numeric ID:

place = 187
start_date = ::LibTAD::TADTime::TADDateTime(year: 2015, month: 1, day: 1)
end_date = ::LibTAD::TADTime::TADDateTime(year: 2015, month: 1, day: 30)
client = ::LibTAD::Client.new(access_key: 'access_key', secret_key: 'secret_key')
astro_events = client.get_astro_events(:moon, place_id: place, start_date: start_date, end_date: end_date)

Retrieve specific astronomy events:

astro_events = client.get_astro_events(:moon, place_id: place, start_date: start_date, types: [:setrise, :twilight])

Retrieve astronomy positions:

astro_position = client.get_astro_position(:moon, place_id: place, interval: [date_1, date_2])

Time Service

Get current time for a place:

place = 179
result = client.get_current_time(place_id: place)

Convert time from a location:

place = "norway/oslo"
datetime = ::LibTAD::TADTime::TADDateTime.new.now
utc, locations = client.convert_time(from_id: place, datetime: datetime)

Convert time from a location using an ISO 8601-string:

utc, locations = client.convert_time(from_id: place, iso: "2015-04-21T16:45:00")

Convert time from one location to multiple locations:

list_of_locations = ["usa/las-vegas", 179]
place = "oslo/norway"
utc, locations = client.convert_time(from_id: place, datetime: datetime, to_id: list_of_locations)

Get all daylight saving times:

all_DST = client.get_daylight_savings_time

Get daylight saving time for a specified year:

result = client.get_daylight_savings_time(year: 2014)

Get daylight saving time for a specified ISO3166-1 (Alpha2) country code:

result = client.get_daylight_savings_time(country: "no")

Holidays Service

Get all holidays for a country by ISO3166-1 (Alpha2) country code:

country = "no"
result = client.get_holidays(country: country)

Get all holidays for a country by year and ISO3166-1 (Alpha2) country code:

country = "no"
result = client.get_holidays(country: country, year: 2014)

Get specific holidays for a country:

country = "no"
result = client.get_holidays(country: country, types: [:federal, :weekdays])

Places Service

Get all places in Time and Date (these can be used to look up data in other services):

result = client.get_places

Date Calculator Service

Add days to a date:

date = ::LibTAD::TADTime::TADDateTime.new.now
geo, period = client.add_days(start_date: date, days: 31)

Subtract days from a date:

geo, period = client.subtract_days(start_date: date, days: 31)

Caclculate the number of business days between two dates:

geo, period = client.get_duration(start_date: start_date, end_date: end_date)