{"id":16805478,"url":"https://github.com/dewski/timezonedb-client-ruby","last_synced_at":"2025-03-17T07:43:45.263Z","repository":{"id":66282044,"uuid":"86772841","full_name":"dewski/timezonedb-client-ruby","owner":"dewski","description":"A Ruby client for the timezonedb.com API","archived":false,"fork":false,"pushed_at":"2016-02-03T15:01:49.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-23T16:53:58.691Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dewski.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-31T03:12:19.000Z","updated_at":"2020-02-17T13:57:08.000Z","dependencies_parsed_at":"2023-04-26T04:12:12.233Z","dependency_job_id":null,"html_url":"https://github.com/dewski/timezonedb-client-ruby","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewski%2Ftimezonedb-client-ruby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewski%2Ftimezonedb-client-ruby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewski%2Ftimezonedb-client-ruby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewski%2Ftimezonedb-client-ruby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dewski","download_url":"https://codeload.github.com/dewski/timezonedb-client-ruby/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243996900,"owners_count":20380978,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T09:48:21.719Z","updated_at":"2025-03-17T07:43:45.242Z","avatar_url":"https://github.com/dewski.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Timezonedb Client\n[![Build Status](https://travis-ci.org/Skyscanner/timezonedb-client-ruby.svg?branch=master)](https://travis-ci.org/Skyscanner/timezonedb-client-ruby)\n[![Gem Version](https://badge.fury.io/rb/timezonedb-client.svg)](https://badge.fury.io/rb/timezonedb-client)\n[![Code Climate](https://codeclimate.com/github/Skyscanner/timezonedb-client-ruby/badges/gpa.svg)](https://codeclimate.com/github/Skyscanner/timezonedb-client-ruby)\n\nA Ruby client for the [timezonedb.com API](https://timezonedb.com/api)\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```\ngem 'timezonedb-client'\n```\n\nAnd then execute:\n\n```\n$ bundle\n```\n\nOr install it yourself as:\n\n```\n$ gem install timezonedb-client\n```\n\n## Usage\n\nInstantiate a new client object providing a Timezonedb API key.\n[Register](https://timezonedb.com/register) to get your API key\n\n```\nclient = Timezonedb::Client.new(api_key)\n```\n\nSearch for the timezone providing latitude and longitude\n\n```\ntz = client.search_by_coords(\"41.3833\", \"2.1833\")\ntz.abbreviation\n=\u003e \"CET\"\ntz.country_code\n=\u003e \"ES\"\ntz.dst\n=\u003e \"0\"\ntz.gmt_offset\n=\u003e \"3600\"\ntz.message\n=\u003e \"\"\ntz.timestamp\n=\u003e 1447847197\ntz.zone_name\n=\u003e \"Europe/Madrid\"\n```\n\nIf you have premium API access, add `premium: true` as a parameter when instantiating\nthe Timezonedb client, otherwise it will use the free plan endpoint.\n\n```\n# will call vip.timezonedb.com instead of api.timezonedb.com\nclient = Timezonedb::Client.new(api_key, premium: true)\n```\n\n## Contributing\n\nWe're glad you want to make a contribution!\n\nFork this repository and send in a pull request when you're finished with your\nchanges. Link any relevant issues in too.\n\nTake note of the build status of your pull request, only builds that pass will\nbe accepted. Please also keep to our conventions and style so we can keep this\nrepository as clean as possible.\n\nBy contributing your code, you agree to license your contribution under the\nterms of the APLv2: http://www.apache.org/licenses/LICENSE-2.0\n\nAll files are released with the Apache 2.0 license.\n\nIf you are adding a new file it should have a header like this:\n\n```\n# Copyright 2015 Skyscanner Limited.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n#\n# you may not use this file except in compliance with the License.\n#\n# You may obtain a copy of the License at\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n#\n# See the License for the specific language governing permissions and\n# limitations under the License.\n```\n\n## License\n\nCopyright 2015 Skyscanner Limited.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\n\nyou may not use this software except in compliance with the License.\n\nYou may obtain a copy of the License at\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdewski%2Ftimezonedb-client-ruby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdewski%2Ftimezonedb-client-ruby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdewski%2Ftimezonedb-client-ruby/lists"}