easytz 0.1.1

A simple and efficient library for seamless time zone conversions — with built-in batch processing for handling multiple datetime objects effortlessly.

easytz

easytz is a simple and efficient Python library for seamless time zone conversions and batch processing of datetime objects. Whether you're converting individual datetime objects across different time zones or handling multiple datetime conversions in one go, easytz makes it fast and straightforward.

Features

• Convert a single datetime object between any two time zones.
• Batch convert a list of datetimes from their respective time zones to a target time zone.
• Batch conversion to multiple time zones from a single datetime object.
• Localize a naive datetime to the system's local time zone.

Installation

To install Easytz, simply use pip:

pip install easytz

Usage Examples

1. Convert a single datetime object between two time zones

from datetime import datetime
import pytz
from easytz.convert import convert_time

# Create a timezone-aware datetime object
from_tz = 'America/New_York'
dt = datetime(2024, 10, 25, 12, 0, 0, tzinfo=pytz.timezone(from_tz))

# Convert to another time zone (only provide the target timezone)
to_tz = 'Europe/London'
converted_time = convert_time(dt, to_tz=to_tz)  # No need to pass from_tz

# Print the result
print(converted_time)  # Output: 2024-10-25 17:00:00+01:00

2. Batch convert a single datetime to multiple time zones

from easytz.convert import batch_convert_to_multiple_timezones
from datetime import datetime
import pytz

# Event time in UTC
event_time = datetime(2024, 10, 25, 15, 0, 0, tzinfo=pytz.UTC)

# List of time zones to convert to
target_timezones = ['America/New_York', 'Europe/London', 'Asia/Tokyo', 'Australia/Sydney']

# Convert the event time to all these time zones
converted_times = batch_convert_to_multiple_timezones(event_time, target_timezones)

# Print the results
for time_data in converted_times:
    print(f"Event time in {time_data['to_tz']}: {time_data['converted_time']}")

3. Batch convert a list of datetimes to a target time zone

from easytz.convert import batch_convert_times

# List of datetime objects from different time zones
times_list = [
    {'time': '2024-10-25 12:00:00', 'from_tz': 'America/New_York'},
    {'time': '2024-10-25 12:00:00', 'from_tz': 'Europe/London'}
]

# The target time zone you want to convert all times to
target_timezone = 'Asia/Tokyo'

converted_times = batch_convert_times(times_list, target_timezone)
print(converted_times)

4. Localize a naive datetime to the system's local time zones

from easytz.convert import localize_to_system_timezone

dt = datetime(2024, 10, 25, 12, 0)  # Naive datetime
localized_dt = localize_to_system_timezone(dt)
print(localized_dt)

Contributing to easytz

Contributions to easytz are welcome! Whether you're fixing a bug, adding a feature, or improving documentation, your help is appreciated.

How to Contribute

1. Fork the Repository:
   Start by forking the easytz repository.

2. Make Your Changes:
   Make the necessary changes, whether it's fixing a bug, adding a new feature, or improving documentation.

3. Submit a Pull Request:
   Once your changes are ready, submit a pull request with a clear description of what you've done. Be sure to include relevant details, such as any bugs fixed or features added.

Code of Conduct

By contributing, you agree to follow the Code of Conduct, ensuring a positive environment for all.

---