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.
Requires Python: >=3.6

# 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:

```bash
pip install easytz

```
## Usage Examples
**1. Convert a single datetime object between two time zones**

```bash
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**

```bash
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**

```bash
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**

```bash
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](https://github.com/vigsun19/easytz).

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.

---