HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
evansiroky
timezone-boundary-builder
JavaScript2019–2025
evansiroky / timezone-boundary-builder

timezone-boundary-builder

A tool to extract data from Open Street Map (OSM) to build the boundaries of the world's timezones.

8Distinct people
10Mentions
0Explicit recommenders
1.1KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

A tool to extract data from Open Street Map (OSM) to build the boundaries of the world's timezones.

GitHub

Where it is used

No documented product use has been verified yet.

What people are saying

No recommendation phrase was found in the indexed comments.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

No other repository is repeatedly linked in the same discussions.

This week on Hacker News

Nov 7–Nov 14 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/14/2026, 3:56:07 PM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year10 dated mentions

Observed mentions: 2019-02-28 08:51:20 UTC to 2025-09-07 12:38:50 UTC.

012342019-01-01 00:00:00 UTC to 2020-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments20192020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments2021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments2022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments20222023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments2024-01-01 00:00:00 UTC to 2025-01-01 00:00:00 UTC (exclusive): 4 mentions; 0 submissions, 4 comments2025-01-01 00:00:00 UTC to 2026-01-01 00:00:00 UTC (exclusive): 3 mentions; 0 submissions, 3 comments2025

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20192019-01-01 00:00:00 UTC2020-01-01 00:00:00 UTC202
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC000
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC000
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC101
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC000
20242024-01-01 00:00:00 UTC2025-01-01 00:00:00 UTC404
20252025-01-01 00:00:00 UTC2026-01-01 00:00:00 UTC303

What Hacker News says

10 sources
Evan Siroky's Timezone Boundary Builder[0] is a good source of time zone boundary mappings. It can be used via a library in nearly any language you would want[1], or loaded directly into Postgres and used with PostGIS in queries[2] (of course, if you load it into your DB you should have a process for keeping it updated). It would be wonderful if Jiff supported coordinates-to-tz lookups out of the box :) [0]: https://github.com/evansiroky/timezone-boundary-builder/rele... [1]: https://github.com/evansiroky/timezone-boundary-builder#look... [2]: https://www.crunchydata.com/blog/timezone-transformation-usi...
In RFC 3339 vs. ISO 8601
It just uses the map that was generated by the TimeZone Boundary Builder[0]. It does fine for my purposes. I just figured it might be useful. One reason that I wrote it, was because I couldn't find a decent SaaS that didn't charge eye-watering prices, for a fairly slow response. I wrote it in an afternoon or two. Not really an ambitious project. I don't usually do "Show HN." Not interested in competing with anyone. If you like it, use it. If you don't like it, don't use it. If there are clear bugs, I'm always open to feedback. [0] https://github.com/evansiroky/timezone-boundary-builder
In Show HN: A Simple Server to Match Long/Lat to a TimeZone
> Earlier this year I had to write a function to find the current local time given a US address. I also did something similar earlier this year, though I used a geolocation service to translate address to lat/long coords, and then used lat/long to translate to timezone. (With shortcuts single-timezone states) I ended up using this python library for lat/long -> timezone converstion: https://github.com/jannikmi/timezonefinder Which sources its data from here, which seems like a pretty high quality source: https://github.com/evansiroky/timezone-boundary-builder/rele...
In Australia/Lord_Howe is the weirdest timezone
I’ve found the best way to deal with TZ conversions, is to use UTC as a common fulcrum. I convert the target TZ to UTC, using my local utility, then use my local TZ utility to convert from UTC to local. But I write iOS software, so I have very solid local tools at hand. It might be more problematic, on, say, a webserver. On a related note, I wrote this utility[0], some time ago. It uses the TZ map from the TZ Boundary Builder project[1]. [0] https://github.com/LittleGreenViper/LGV_TZ_Lookup [1] https://github.com/evansiroky/timezone-boundary-builder
In Australia/Lord_Howe is the weirdest timezone
They don't really bother me. They aren't AI spam, and some folks may enjoy them. It's pretty easy to not click on a link, for me. TZ are a fun project. I found that it's difficult to translate a long/lat into a TZ ID, so I wrote this[0]. Works a charm. It's based on the Timezone Boundary Builder[1]. [EDIT] Looks like I'll have to revisit the tests. The latest boundary map is much smaller, and triggers a bunch of errors. Most of my tests are just around boundaries. In the meantime, use the 2023b release. [0] https://github.com/LittleGreenViper/LGV_TZ_Lookup [1] https://github.com/evansiroky/timezone-boundary-builder
In Falsehoods programmers believe about time zones (2020)
I wrote a tutorial on SpatiaLite here: https://datasette.io/tutorials/spatialite - "Building a location to time zone API with SpatiaLite" It shows how to use SpatiaLite + Datasette to build an API that can tell you what timezone a latitude/longitude point is in, using data derived from OpenStreetMap via https://github.com/evansiroky/timezone-boundary-builder Here's a demo: https://timezones.datasette.io/timezones/by_point?longitude=... - add ".json" to the URL for the JSON output.
In SpatiaLite: Library extending SQLite to support Spatial SQL capabilities

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.