Ruby SDK

Install

gem install timenow

Or add to your Gemfile:

gem 'timenow', '~> 1.0'

Quick Start

require 'timenow'

client = TimeNow::Client.new('http://localhost:8090')

# Solar time for London
result = client.solar_time(lat: 51.5074, lng: -0.1278)
puts result.solar_time             # "2026-04-14T11:49:23"
puts result.civil_solar_offset_min # -10.6

# Social jetlag
jetlag = client.jetlag(lat: 39.47, lng: 75.99)
puts jetlag.risk_level  # "severe"

# Prayer times
prayers = client.prayer_times(lat: 51.5074, lng: -0.1278, convention: 'mwl')
puts prayers.dhuhr[:civil]  # "13:11"

Methods

Method	Parameters	Returns	API endpoint
`solar_time(lat:, lng:, utc: nil)`	keyword args	`SolarTimeResult`	`GET /solar`
`jetlag(lat:, lng:)`	keyword args	`JetlagResult`	`GET /solar/jetlag`
`prayer_times(lat:, lng:, date: nil, convention: 'mwl')`	keyword args	`PrayerTimesResult`	`GET /solar/prayer`
`almanac(lat:, lng:, year: nil)`	keyword args	`AlmanacResult`	`GET /solar/almanac`
`deviation_map(format: :json)`	keyword arg	`Hash` or `String`	`GET /world/deviation-map`
`health`	—	`Boolean`	`GET /health`