shamsi-datetime 0.2.0

A Shamsi (Jalali) datetime class for NumPy integration

Shamsi DateTime

ShamsiDateTime is a Python package developed by Ali Razmjooei that provides a class for working with Shamsi (Jalali) dates. This package integrates seamlessly with NumPy, enabling you to handle Shamsi dates and convert them to and from Gregorian dates.

Overview

The Shamsi DateTime package allows you to:

• Create and manipulate Shamsi (Jalali) dates.
• Convert Shamsi dates to Gregorian dates and vice versa.
• format dates in both Persian and English.
• Easily integrate with NumPy for date manipulations and analysis.

Installation

To install the package, use pip:

pip install shamsi-datetime

Basic Usage

from shamsi_datetime import ShamsiDateTime
# if you are using with numpy
import numpy as np

# Create a Shamsi date with specific values
# میتونید ورودی رو خالی بزارید یا دلخواه وارد کنید (روز، ماه، سال)
shamsi_date = ShamsiDateTime(1403, 5, 6)
print(f"\nتاریخ شمسی دلخواه: {shamsi_date}")

# Create a Shamsi date with the current date
# تاریخ امروز
current_shamsi_date = ShamsiDateTime()
print(f"تاریخ امروز: {current_shamsi_date}")

# Convert to Gregorian (NumPy datetime64)
# تبدیل تاریخ شمسی به میلادی بر حسب تاریخ امروز یا تاریخ ورودی دلخواه
gregorian_date = shamsi_date.to_gregorian()
print(f"تاریخ میلادی برحسب تاریخ شمسی: {gregorian_date}")

# Convert back to Shamsi
# با استفاده از متد زیر میتونید تاریخ میلادی رو به شمسی تبدیل کنید
shamsi_converted_back = ShamsiDateTime.from_gregorian(gregorian_date)
print(f"تبدیل تاریخ میلادی به شمسی: {shamsi_converted_back}\n")

Features

• ShamsiDateTime Class: Represents Shamsi dates with easy conversion to and from Gregorian dates.
• Conversion Methods: Convert between Shamsi dates and Gregorian dates using NumPy's datetime64.
• Integration with NumPy: Leverages NumPy for efficient date operations.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

If you would like to contribute to the development of ShamsiDateTime, please fork the repository and submit a pull request. For any issues or feature requests, please open an issue on the GitHub repository.

Contact

For any questions or feedback, you can reach out to the author:

• Ali Razmjooei: [e-mail]
• GitHub