============== timezonefinder ============== .. Note: can't include the badges file from the docs here, as it won't render on PyPI -> sync manually .. image:: https://github.com/jannikmi/timezonefinder/actions/workflows/build.yml/badge.svg?branch=master :target: https://github.com/jannikmi/timezonefinder/actions?query=branch%3Amaster .. image:: https://readthedocs.org/projects/timezonefinder/badge/?version=latest :alt: documentation status :target: https://timezonefinder.readthedocs.io/en/latest/?badge=latest .. image:: https://img.shields.io/pypi/wheel/timezonefinder.svg :target: https://pypi.python.org/pypi/timezonefinder .. image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white :target: https://github.com/pre-commit/pre-commit :alt: pre-commit .. image:: https://pepy.tech/badge/timezonefinder :alt: total PyPI downloads :target: https://pepy.tech/project/timezonefinder .. image:: https://img.shields.io/pypi/v/timezonefinder.svg :alt: latest version on PyPI :target: https://pypi.python.org/pypi/timezonefinder .. image:: https://img.shields.io/conda/vn/conda-forge/timezonefinder.svg :target: https://anaconda.org/conda-forge/timezonefinder :alt: latest version on conda-forge .. image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/psf/black Notice: Looking for maintainers. Reach out if you want to contribute! --------------------------------------------------------------------- This is a python package for looking up the corresponding timezone for given coordinates on earth entirely offline. Quick Guide ----------- It is recommended to install it together with the optional `Numba `__ package for increased performance: .. code-block:: console pip install timezonefinder[numba] .. code-block:: python 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 a dataset optimized for the primary use case of timezone determination for current/future time calculations. For applications requiring historical accuracy or resolving to precise locations, consider parsing the original dataset (cf. Chapter "Data Format" in the Documentation). Need maximum speed at the cost of accuracy? Check out `tzfpy `__ - a fast alternative based on Rust. References ---------- * `Documentation `__ * `PyPI `__ * `conda-forge feedstock `__ * `download stats `__ * `online GUI and API `__ * `GUI repository `__ * `ruby port `__ 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 `__.

timezonefinder8.0.0

Package Downloads

Authors

Project URLs

Requires Python

Dependencies