Development Status
- 5 - Production/Stable
Intended Audience
- Developers
- Information Technology
Natural Language
- English
Operating System
- OS Independent
Topic
- Software Development :: Localization
Programming Language
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
- Python :: 3.14
This is a python package providing offline timezone lookups for WGS84 coordinates. In comparison to other alternatives this package aims at maximum accuracy around timezone borders (no geometry simplifications) while offering fast lookup performance and compatibility with many (Python) runtime environments. It combines preprocessed polygon data, H3-based spatial shortcuts, and optional acceleration via Numba or a clang-backed point-in-polygon routine.
Notice: Looking for maintainers. Reach out if you want to contribute!
Quick Guide
It is recommended to install it together with the optional Numba package for increased performance:
pip install timezonefinder[numba]from timezonefinder import timezone_at
tz = timezone_at(lng=13.358, lat=52.5061) # 'Europe/Paris'
# For thread safety, increased performance and control, re-use an instance:
from timezonefinder import TimezoneFinder
tf = TimezoneFinder(in_memory=True) # reuse
query_points = [(13.358, 52.5061), ...]
for lng, lat in query_points:
tz = tf.timezone_at(lng=lng, lat=lat) # 'Europe/Paris'Note: This library uses the full original timezone dataset with all >440 timezone names, providing full localization capabilities and historical timezone accuracy. For applications that prefer a smaller memory footprint, the reduced “timezones-now” dataset is available via the parse_data.sh script (cf. Documentation).
Alternative: Need maximum speed at the cost of accuracy? Check out tzfpy - a fast and lightweight alternative based on Rust.
References
LICENSE
timezonefinder is licensed under the MIT license.
The data is licensed under the ODbL license, following the base dataset from evansiroky/timezone-boundary-builder.
Wheel compatibility matrix
| Platform | CPython >=3.9 (abi3) |
|---|---|
| manylinux1_x86_64 | |
| manylinux2014_x86_64 | |
| manylinux_2_17_x86_64 | |
| manylinux_2_5_x86_64 | |
| musllinux_1_1_x86_64 |
