https://github.com/svidaniya/yamtimes
Modern Date and Time Handling library for Python.
https://github.com/svidaniya/yamtimes
datetime datetime-format manipulation python temporal time
Last synced: 4 months ago
JSON representation
Modern Date and Time Handling library for Python.
- Host: GitHub
- URL: https://github.com/svidaniya/yamtimes
- Owner: svidaniya
- License: mit
- Created: 2024-12-27T14:43:20.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-27T14:54:35.000Z (over 1 year ago)
- Last Synced: 2024-12-27T15:09:45.627Z (over 1 year ago)
- Topics: datetime, datetime-format, manipulation, python, temporal, time
- Language: Python
- Homepage: https://pypi.org/project/yamtimes/
- Size: 0 Bytes
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# YamTimes
**YamTimes** is a modern, lightweight Python library for date and time manipulation, offering an intuitive API for common temporal operations. It provides a clean interface for working with dates, times, and timezones while maintaining simplicity and performance.
## 🚀 Key Features
### 📅 Comprehensive Date Handling
```python
# Easy date creation and formatting
time = YamTimes(2024, 3, 15)
print(time.to_string("%Y-%m-%d")) # "2024-03-15"
# Check business days
time.is_weekday() # True
time.next_business_day() # Skip weekends
```
### ⏰ Time Manipulation
```python
# Time arithmetic
time.add_hours(24)
time.subtract_minutes(30)
time.next_week()
time.last_month()
```
### 🌟 Smart Date Features
```python
# Zodiac sign detection
time.is_aries_sign() # Check if date falls in Aries
time.is_pisces_sign() # Check if date falls in Pisces
# Date comparison
time.is_weekend() # Check if it's weekend
time.is_holiday("US") # Check if it's a holiday
```
### 🌍 Internationalization
```python
# Get localized names
time.month_name("pt_BR") # "Março"
time.weekday_name("es_ES") # "Viernes"
```
### 📊 Date Analysis
```python
# Period calculations
time.days_in_month() # Get days in current month
time.is_leap_year() # Check if current year is leap
time.weeks_in_year() # Get number of weeks in year
```
### ⚡ Performance
- Lightweight wrapper around Python's datetime
- Fast execution for common operations
## 🛠️ Installation
```bash
pip install yamtimes
```
## 📚 Documentation
Full documentation available at [YamTimes Wiki](https://github.com/svidaniya/yamtimes/wiki)
## 📝 License
MIT License