datetime و time

datetime و time — التواريخ والأوقات في Python

كل تطبيق حقيقي يتعامل مع الوقت — سجلات التحويلات المالية، مواعيد الحجوزات، فواتير التاريخ، تقارير يومية أو شهرية. Python توفر وحدة datetime في مكتبتها المعيارية تحل هذه المشكلة بشكل كامل ودون الحاجة لأي مكتبة خارجية.

وحدة datetime تحتوي على عدة كلاسات رئيسية:

الكلاس	ما يمثّله
`date`	تاريخ فقط (سنة، شهر، يوم)
`time`	وقت فقط (ساعة، دقيقة، ثانية)
`datetime`	تاريخ + وقت معاً
`timedelta`	فرق زمني (مدة)
`timezone`	منطقة زمنية

إنشاء كائنات datetime

الطريقة الأكثر استخداماً هي datetime.now() للحصول على اللحظة الحالية، وdatetime(year, month, day) لإنشاء تاريخ محدد:

main.go

from datetime import datetime, date, timedelta

# اللحظة الحالية — Current moment
now = datetime.now()
print("الآن:", now)
print("نوع البيانات:", type(now))

# تاريخ اليوم فقط — Date only
today = date.today()
print("اليوم:", today)

# إنشاء تاريخ محدد — Specific date
launch = datetime(2024, 1, 15, 9, 30, 0)  # 15 يناير 2024، الساعة 9:30
print("تاريخ الإطلاق:", launch)

# الوصول للمكونات — Access components
print(f"السنة: {now.year}, الشهر: {now.month}, اليوم: {now.day}")
print(f"الساعة: {now.hour}, الدقيقة: {now.minute}, الثانية: {now.second}")

Output:

الحساب الزمني مع timedelta

timedelta هو ما يجعل datetime قوياً حقاً — يمكنك جمع الأوقات وطرحها بكل سهولة. تخيّل أنك تريد معرفة تاريخ انتهاء اشتراك بعد 30 يوماً من اليوم، أو كم مضى على تاريخ معين:

main.go

from datetime import datetime, timedelta

now = datetime.now()

# الحساب الزمني — Time arithmetic
غداً = now + timedelta(days=1)
أسبوع_بعد = now + timedelta(weeks=1)
قبل_ثلاثة_أشهر = now - timedelta(days=90)
بعد_ساعتين = now + timedelta(hours=2)

print("الآن:", now.strftime("%Y-%m-%d %H:%M"))
print("غداً:", غداً.strftime("%Y-%m-%d %H:%M"))
print("بعد أسبوع:", أسبوع_بعد.strftime("%Y-%m-%d %H:%M"))
print("قبل 90 يوماً:", قبل_ثلاثة_أشهر.strftime("%Y-%m-%d"))
print("بعد ساعتين:", بعد_ساعتين.strftime("%Y-%m-%d %H:%M"))

# حساب الفرق بين تاريخين — Difference between dates
start = datetime(2024, 1, 1)
end = datetime(2024, 12, 31)
diff = end - start
print(f"\nمدة عام 2024: {diff.days} يوماً")

# انتهاء اشتراك — Subscription expiry
اشتراك_بدأ = datetime(2024, 3, 1)
مدة_الاشتراك = timedelta(days=30)
انتهاء = اشتراك_بدأ + مدة_الاشتراك
print(f"الاشتراك ينتهي: {انتهاء.strftime('%Y-%m-%d')}")

Output:

تنسيق التواريخ — strftime

strftime (string format time) تحوّل كائن datetime إلى نص منسّق بالشكل الذي تريده. الاسم يُقرأ: “string format time”.

رموز التنسيق الأساسية:

الرمز	المعنى	مثال
`%Y`	السنة كاملة	`2024`
`%m`	الشهر بأرقام	`03`
`%d`	اليوم بأرقام	`15`
`%H`	الساعة (24)	`14`
`%M`	الدقائق	`30`
`%S`	الثواني	`05`
`%A`	اسم اليوم	`Monday`
`%B`	اسم الشهر	`March`

main.go

from datetime import datetime

now = datetime.now()

# تنسيقات مختلفة — Different formats
print(now.strftime("%Y-%m-%d"))           # 2024-03-15
print(now.strftime("%d/%m/%Y"))           # 15/03/2024
print(now.strftime("%Y-%m-%d %H:%M:%S")) # 2024-03-15 14:30:05
print(now.strftime("%A, %B %d, %Y"))     # Monday, March 15, 2024

# تنسيق للفاتورة — Invoice format
print("\nرقم الفاتورة بتنسيق مخصص:")
رقم = f"INV-{now.strftime('%Y%m%d')}-001"
print(رقم)  # INV-20240315-001

# تنسيق قابل للقراءة — Human readable
print("\nللعرض للمستخدم:")
print(now.strftime("%-d %B %Y الساعة %H:%M"))

Output:

تحليل النصوص — strptime

العملية العكسية: تحويل نص يمثّل تاريخاً إلى كائن datetime. strptime (string parse time) تحتاج أن تخبرها بتنسيق النص المُدخل:

main.go

from datetime import datetime

# تحليل نص تاريخ — Parse date string
نص1 = "2024-03-15"
تاريخ1 = datetime.strptime(نص1, "%Y-%m-%d")
print("تم التحليل:", تاريخ1)
print("النوع:", type(تاريخ1))

# تنسيقات مختلفة — Different formats
نص2 = "15/03/2024 14:30"
تاريخ2 = datetime.strptime(نص2, "%d/%m/%Y %H:%M")
print("التاريخ 2:", تاريخ2)

# قراءة من سجل (log) — Parse from log
سجل = "2024-01-20T08:45:00"
تاريخ_سجل = datetime.strptime(سجل, "%Y-%m-%dT%H:%M:%S")
print("وقت السجل:", تاريخ_سجل)

# مثال عملي: هل الحدث حدث هذا الأسبوع؟ — Is event this week?
from datetime import timedelta
now = datetime.now()
حدث = datetime.strptime("2024-01-20 10:00", "%Y-%m-%d %H:%M")
# نقارن بسنة حالية للديمو — Compare using current year for demo
حدث_هذا_العام = datetime(now.year, now.month, max(1, now.day - 3), 10, 0)
فرق = now - حدث_هذا_العام
print(f"\nالحدث كان منذ {فرق.days} يوم")

Output:

المناطق الزمنية — timezone

التعامل الأساسي مع المناطق الزمنية بدون مكتبات خارجية. UTC هو المنطقة الزمنية العالمية المرجعية، والسعودية تبعد +3 ساعات عنها:

main.go

from datetime import datetime, timezone, timedelta

# UTC — التوقيت العالمي المنسّق
now_utc = datetime.now(timezone.utc)
print("الآن بتوقيت UTC:", now_utc.strftime("%Y-%m-%d %H:%M:%S %Z"))

# منطقة زمنية يدوية — Manual timezone (Arabia Standard Time = UTC+3)
AST = timezone(timedelta(hours=3))
now_ksa = datetime.now(AST)
print("الآن بتوقيت السعودية:", now_ksa.strftime("%Y-%m-%d %H:%M:%S"))

# تحويل بين المناطق — Convert between timezones
utc_time = datetime(2024, 3, 15, 12, 0, 0, tzinfo=timezone.utc)
ksa_time = utc_time.astimezone(AST)
print(f"\nUTC: {utc_time.strftime('%H:%M')}")
print(f"KSA: {ksa_time.strftime('%H:%M')}")

# datetime بدون منطقة زمنية (naive) vs. مع منطقة (aware)
naive = datetime(2024, 1, 1)          # بدون منطقة — naive
aware = datetime(2024, 1, 1, tzinfo=timezone.utc)  # مع منطقة — aware
print(f"\nnaive tzinfo: {naive.tzinfo}")
print(f"aware tzinfo: {aware.tzinfo}")

Output:

أنماط استخدام datetime في الواقع

في المشاريع الحقيقية، datetime يظهر في سياقات محددة ومتكررة. إليك الأنماط التي ستحتاجها أكثر من غيرها:

1. تسجيل وقت الحدث (Timestamping)

from datetime import datetime, timezone
حدث = {"نوع": "تسجيل_دخول", "وقت": datetime.now(timezone.utc).isoformat()}

2. التحقق من انتهاء الصلاحية (Expiry Check)

from datetime import datetime, timedelta
انتهاء_الرمز = datetime.now() + timedelta(hours=1)
if datetime.now() > انتهاء_الرمز:
    raise ValueError("انتهت صلاحية الرمز")

3. فلترة السجلات حسب نطاق زمني (Date Range Filtering)

from datetime import datetime, timedelta
آخر_ساعة = datetime.now() - timedelta(hours=1)
سجلات_الساعة = [س for س in السجلات if س["وقت"] >= آخر_ساعة]

4. تنسيق واجهة المستخدم (UI Formatting)

from datetime import datetime
تاريخ = datetime(2024, 3, 15)
print(تاريخ.strftime("%d %B %Y"))  # 15 March 2024

هذه الأنماط الأربعة تغطي 90% من احتياجاتك اليومية مع datetime. ستراها مجتمعة في الدرس التطبيقي (py-08-04) حين نبني محلل السجلات.

خلاصة سريعة

datetime.now() ← الوقت الحالي
datetime(y, m, d) ← تاريخ محدد
timedelta(days=N) ← فرق زمني، يُضاف أو يُطرح
dt.strftime("%Y-%m-%d") ← كائن → نص
datetime.strptime(نص, تنسيق) ← نص → كائن
timezone.utc و timezone(timedelta(hours=3)) ← إدارة المناطق الزمنية

تحدي — Challenge

from datetime import datetime, timedelta

# احسب تاريخ بعد 30 يوماً من 1 يناير 2024
# ثم اطبع رقم اليوم فقط
# Calculate the date 30 days after Jan 1, 2024 and print only the day number
بداية = datetime(2024, 1, 1)
# اكتب الكود هنا — write your code here