Registry / serialization / timezone-tools

timezone-tools

library0.1.0.post1pypypi✓ verified 85d ago

A Python library providing utilities for working with timezone-aware datetimes, including conversion, formatting, and common timezone operations. Current version 0.1.0.post1, requires Python >=3.10. Active development.

serialization observability

pip install timezone-tools

github ↗package ↗changelog ↗

INSTALL

IMPORT

SIG · TIMEZONE-TOOLS

timezone-tools

serializationpythonv0.1.0.post1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TimezoneConverter

✓ from timezone_tools import TimezoneConverter

✗ from timezone_tools.converter import TimezoneConverter

Importing from submodule may not be exposed.

format_aware_datetime

✓ from timezone_tools import format_aware_datetime

✗ from timezone_tools.utils import format_aware_datetime

Utilities are not a public submodule.

utcnow

✓ from timezone_tools import utcnow

✗ from timezone_tools.helpers import utcnow

Helper functions are accessible directly from package.

Initialize a TimezoneConverter, create an aware datetime in a specific timezone, and format it using a custom pattern.

from timezone_tools import TimezoneConverter, format_aware_datetime from datetime import datetime import os tz = 'America/New_York' converter = TimezoneConverter() dt = datetime.now(tz=tz) formatted = format_aware_datetime(dt, 'YYYY-MM-DD HH:mm:ss') print(formatted)

Debug

Known issues

gotchaTimezoneConverter may use pytz timezone objects; ensure you pass a valid IANA timezone string (e.g., 'America/New_York'). Invalid strings may raise a pytz.exceptions.UnknownTimeZoneError.

fix

Use only valid IANA timezone identifiers. Check with pytz.all_timezones if unsure.

affects: all

gotchaThe library is in an early release (0.1.0.post1). APIs may change without notice. Pin your dependency to a specific version in production.

fix

Pin to timezone-tools==0.1.0.post1 in requirements.txt or setup.py.

affects: <=0.1.0.post1

deprecatedThe use of 'pytz' is deprecated in favor of 'zoneinfo' (available in Python 3.9+). This library currently uses pytz, but future versions may migrate to zoneinfo.

fix

Prepare to migrate code that relies on pytz behavior; monitor the library's future releases.

affects: >=0.1.0

Errors

Common errors & fixes

pytz.exceptions.UnknownTimeZoneError: 'US/Eastern'

Using an outdated or incorrect timezone string. 'US/Eastern' is deprecated; use 'America/New_York'.

fix

Replace 'US/Eastern' with 'America/New_York' or another valid IANA timezone.

AttributeError: 'TimezoneConverter' object has no attribute 'convert'

The method may be named differently or not exist in the current version.

fix

Check the API documentation. Likely use `converter.to_timezone(dt, target_tz)` instead of `convert`.

Upgrade

Version history

0.1.0.post1latest on PyPI · released May 2, 2025

Audit

Dependencies

pytzrequiredUsed for timezone database and timezone objects

python-dateutilrequiredUsed for parsing and handling dates

Agent activity

23 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/kraken-tech/timezone-tools ↗

packagehttps://pypi.org/project/timezone-tools/ ↗

changeloghttps://github.com/kraken-tech/timezone-tools/blob/main/CHANGELOG.md ↗