{"id":13507780,"url":"https://github.com/lau/tzdata","last_synced_at":"2026-02-20T16:01:37.343Z","repository":{"id":27861082,"uuid":"31351789","full_name":"lau/tzdata","owner":"lau","description":"tzdata for Elixir. Born from the Calendar library.","archived":false,"fork":false,"pushed_at":"2025-03-06T06:30:06.000Z","size":4018,"stargazers_count":316,"open_issues_count":28,"forks_count":78,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-10-21T19:04:28.028Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Elixir","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lau.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-02-26T05:17:14.000Z","updated_at":"2025-09-22T13:18:05.000Z","dependencies_parsed_at":"2022-09-03T16:00:24.000Z","dependency_job_id":"23bbc3bf-b5a4-4e77-8715-e9089c14890f","html_url":"https://github.com/lau/tzdata","commit_stats":{"total_commits":208,"total_committers":27,"mean_commits":7.703703703703703,"dds":"0.20673076923076927","last_synced_commit":"e63fc28c02d79dec9ea56e6cecf721f595a18495"},"previous_names":[],"tags_count":48,"template":false,"template_full_name":null,"purl":"pkg:github/lau/tzdata","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lau%2Ftzdata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lau%2Ftzdata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lau%2Ftzdata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lau%2Ftzdata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lau","download_url":"https://codeload.github.com/lau/tzdata/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lau%2Ftzdata/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29656589,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T09:27:29.698Z","status":"ssl_error","status_checked_at":"2026-02-20T09:26:12.373Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-08-01T02:00:38.976Z","updated_at":"2026-02-20T16:01:37.324Z","avatar_url":"https://github.com/lau.png","language":"Elixir","funding_links":[],"categories":["Date and Time"],"sub_categories":[],"readme":"Tzdata\n======\n\n[![Build\nStatus](https://travis-ci.org/lau/tzdata.svg?branch=master)](https://travis-ci.org/lau/tzdata)\n[![Hex.pm version](https://img.shields.io/hexpm/v/tzdata.svg)](http://hex.pm/packages/tzdata)\n[![Hex.pm downloads](https://img.shields.io/hexpm/dt/tzdata.svg)](https://hex.pm/packages/tzdata)\n\nTzdata. The [timezone database](https://www.iana.org/time-zones) in Elixir.\n\nExtracted from the [Calendar](https://github.com/lau/calendar) library.\n\nAs of version 1.1.3 the tz release 2025a is included in the package.\n\nWhen a new release is out, it will be automatically downloaded at runtime.\n\nThe tz release version in use can be verified with the following function:\n\n```elixir\niex\u003e Tzdata.tzdata_version\n\"2024b\"\n```\n\n## Getting started\n\nTo use the Tzdata library with Elixir 1.8+, add it to the dependencies in your mix file:\n\n```elixir\ndefp deps do\n  [  {:tzdata, \"~\u003e 1.1\"},  ]\nend\n```\n\nIn your application you can choose to globally configure Elixir to use Tzdata.\nThis can be done by putting the following line in the config file of your application:\n\n    config :elixir, :time_zone_database, Tzdata.TimeZoneDatabase\n\nThat's it!\n\nThat allows you to [use the Elixir standard library to use Tzdata to do time zone calculations](https://hexdocs.pm/elixir/DateTime.html#content).\nOne example is getting the current time in a certain time zone:\n\n```elixir\niex\u003e DateTime.now(\"Europe/Copenhagen\")\n{:ok, #DateTime\u003c2018-11-30 20:51:59.076524+01:00 CET Europe/Copenhagen\u003e}\n```\n\nIf you do not want Elixir to have a time zone database globally defined you can instead pass\nthe module name `Tzdata.TimeZoneDatabase` directly to the functions that need a time zone database:\n\n```elixir\nDateTime.now(\"Europe/Copenhagen\", Tzdata.TimeZoneDatabase)\n```\n\n## Data directory and releases\n\nThe library uses a file directory to store data. By default this directory\nis `priv`. In some cases you might want to use a different directory. For\ninstance when using releases this is recommended. If so, create the directory and\nmake sure Elixir can read and write to it. Then use elixir config files like this\nto tell Tzdata to use that directory:\n\n```elixir\nconfig :tzdata, :data_dir, \"/etc/elixir_tzdata_data\"\n```\n\nAdd the `release_ets` directory from `priv` to that directory\ncontaining the `20xxx.ets` file that ships with this library.\n\nFor instance with this config: `config :tzdata, :data_dir, \"/etc/elixir_tzdata_data\"`\nan `.ets` file such as `/etc/elixir_tzdata_data/release_ets/2017b.ets` should be present.\n\n## Automatic data updates\n\nBy default Tzdata will poll for timezone database updates every day.\nIn case new data is available, Tzdata will download it and use it.\n\nThis feature can be disabled with the following configuration:\n\n```elixir\nconfig :tzdata, :autoupdate, :disabled\n```\n\nIf the autoupdate setting is set to disabled, one has to manually put updated .ets files\nin the release_ets sub-dir of the \"data_dir\" (see the \"Data directory and releases\" section above).\nWhen IANA releases new versions of the time zone data, this Tzdata library can be used to generate\na new .ets file containing the new data.\n\n## Changes from 0.1.x to 0.5.x\n\nThe 0.5.1+ versions uses ETS tables and automatically polls the IANA\nservers for updated data. When a new version of the timezone database\nis available, it is automatically downloaded and used.\n\nFor use with [Calendar](https://github.com/lau/calendar) you can still\nspecify tzdata ~\u003e 0.1.7 in your mix.exs file in case you experience problems\nusing version ~\u003e 0.5.20\n\n## Hackney dependency and security\n\nTzdata depends on Hackney in order to do HTTPS requests to get new updates. This is done because Erlang's built in HTTP client `httpc` does not verify SSL certificates when doing HTTPS requests. Hackney verifies the certificate of IANA when getting new tzdata releases from IANA.\n\n## Documentation\n\nDocumentation can be found at http://hexdocs.pm/tzdata/\n\n## When new timezone data is released\n\nIANA releases new versions of the [timezone database](https://www.iana.org/time-zones) frequently.\n\nFor users of Tzdata version 0.5.x+ the new database will automatically\nbe downloaded, parsed, saved and used in place of the old data.\n\n## License\n\nThe tzdata Elixir library is released under the MIT license. See the LICENSE file.\n\nThe tz database files (found in the source_data directory of early versions) is public domain.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flau%2Ftzdata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flau%2Ftzdata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flau%2Ftzdata/lists"}