ziptimezone

https://img.shields.io/badge/code%20style-black-000000.svg

This is a python package with US Zip Code convenience functions such as those listed in the examples below. It uses the geonames data, coupled with the timezonefinder package. It uses a mapping of the popular timezone regions in US, and returns the outputs accordingly. Latest release includes dependency fixes and documentation updates.

Quick Guide:

pip install ziptimezone

import ziptimezone as zpt

# returns a tuple (42.377, -71.1256)
zpt.get_lat_long_for_zip('02138')

# returns 'Eastern' the timezone has been reduced to the more popular zones
# for United States Regions
zpt.get_timezone_by_zip('02138')

# returns a dictionary, {'02138': 'Eastern', '85260': 'Mountain'}
zpt.get_timezone_for_many_zips(['02138', '85260'])

# returns a string, '02138 is ahead of 72201 by 1.00 hours."}
zpt.calculate_time_difference_between_zips(['02138', '72201'])

# returns a dictionary, for 5/30/24 {'sunrise_time': '05:11:13', 'sunset_time': '20:13:31'}
today_sun_times = get_sunrise_sunset_for_zip("02138")

# Get sunrise and sunset times for ZIP code 02138 on July 4, 2024
# will return {'sunrise_time': '05:13:42', 'sunset_time': '20:24:10'}
july4_sun_times = get_sunrise_sunset_for_zip("02138", datetime(2024, 7, 4).date())

For more refer to the Documentation.

Also check:

PyPI

Metadata

Release files for ziptimezone 1.1.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ziptimezone 1.1.8
File	Size	Uploaded
ziptimezone-1.1.8.tar.gz	8.0 kB	May 30, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for ziptimezone 1.1.8
File	Interpreter	ABI	Platform	Reset
ziptimezone-1.1.8-py3-none-any.whl 9.8 kB May 30, 2024	Python 3	none	any	Details

Total release size: 17.8 kB

Release files / ziptimezone-1.1.8.tar.gz

Download URL	ziptimezone-1.1.8.tar.gz
Size	8.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`68d880e40f1b50d696ff5fff215653b267a588582e0891d1a63b867ad6ccbecf`
BLAKE2b-256 checksum How to use checksums	`f8333f6b098254450ad54d1d5d36b33c932ca65a46293d54c118beb5599b1012`
Upload date	May 30, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.2 CPython/3.11.9 Windows/10`

Release files / ziptimezone-1.1.8-py3-none-any.whl

Download URL	ziptimezone-1.1.8-py3-none-any.whl
Size	9.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9d736502362998e4ac8ef77edbe87a64049a3ad705734b91839c155dd73681bc`
BLAKE2b-256 checksum How to use checksums	`bb85de1441cebbd238ccc14034db5b7efd766176b578ea138343f78924eaa30a`
Upload date	May 30, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.2 CPython/3.11.9 Windows/10`