recent
أخبار ساخنة

التاريخ والوقت Date and Time في لغة بايثون 13

AM VIIP
الصفحة الرئيسية
التاريخ و الوقت في لغة بايثون

التاريخ والوقت Date and Time في لغة بايثون Python

التاريخ و الوقت ( date and time ) في بايثون, توجد الكثير من المكاتب module التي تساعدنا على عرض التاريخ و الوقت, و كما واضح من إسم الدرس أننا نتعامل مع التاريخ و الوقت, هو مهم في حال كنا نعمل على كود أو تطبيق ونريد عرض التاريخ و الوقت عليه.

عند تطوير البرامج باستخدام لغة Python، قد نحتاج إلى التعامل مع التاريخ والوقت في العديد من الحالات، مثل تسجيل وقت إنشاء الملفات، أو معرفة تاريخ اليوم، أو حساب عدد الأيام المتبقية حتى موعد معين، أو إنشاء نظام لحجز المواعيد، أو تسجيل أوقات دخول المستخدمين وخروجهم.

توفر لغة Python مجموعة من المكتبات المدمجة التي تساعدنا على التعامل مع التاريخ والوقت بسهولة، ومن أهمها:

  • مكتبة datetime: للتعامل مع التواريخ والأوقات وإجراء العمليات الحسابية عليها.
  • مكتبة time: للتعامل مع الوقت الحالي والطوابع الزمنية والانتظار وقياس مدة التنفيذ.
  • مكتبة calendar: للتعامل مع التقويم وعرض الأشهر والسنوات ومعرفة الأيام.

في هذا المقال سنتعرف على أهم الدوال والخصائص الموجودة في هذه المكتبات، مع أمثلة عملية تساعدك على فهم طريقة استخدامها في مشاريعك.

مكتبة datetime في لغة بايثون

تُعد مكتبة datetime من أهم المكتبات المستخدمة للتعامل مع التاريخ والوقت في Python.

تأتي هذه المكتبة مدمجة مع اللغة، لذلك لا تحتاج إلى تثبيتها باستخدام pip.

لاستخدامها يمكننا استيرادها بالطريقة التالية:

import datetime

أو استيراد الكلاسات التي نحتاج إليها مباشرة:

from datetime import datetime, date, time, timedelta

تحتوي المكتبة على عدة كلاسات مهمة، من أبرزها:

الكلاسالاستخدام
dateالتعامل مع التاريخ فقط
timeالتعامل مع الوقت فقط
datetimeالتعامل مع التاريخ والوقت معًا
timedeltaحساب الفترات الزمنية والفرق بين التواريخ
timezoneالتعامل مع المناطق الزمنية والإزاحات الزمنية

الحصول على التاريخ الحالي باستخدام date.today()

إذا أردنا معرفة تاريخ اليوم دون الحاجة إلى الوقت، يمكننا استخدام date.today().

مثال:

import datetime
today = datetime.date.today()
print(today)

قد تكون النتيجة:

2026-11-18

تظهر النتيجة بالترتيب التالي:

السنة-الشهر-اليوم

يمكننا أيضًا الوصول إلى كل جزء من التاريخ بشكل منفصل:

import datetime
today = datetime.date.today()
print("Year:", today.year)
print("Month:", today.month)
print("Day:", today.day)

النتيجة:

Year: 2026
Month: 11
Day: 18

تساعدنا هذه الخصائص على استخدام أجزاء التاريخ بشكل منفصل داخل البرامج.

الحصول على التاريخ والوقت الحاليين باستخدام datetime.now()

إذا أردنا الحصول على التاريخ والوقت معًا، يمكننا استخدام الدالة now().

مثال:

import datetime
now = datetime.datetime.now()
print(now)

قد تكون النتيجة:

2026-11-18 08:57:30.123456

تحتوي النتيجة على:

  • السنة Year.
  • الشهر Month.
  • اليوم Day.
  • الساعة Hour.
  • الدقيقة Minute.
  • الثانية Second.
  • أجزاء من الثانية Microsecond.

يمكننا الوصول إلى كل قيمة بشكل منفصل:

import datetime
now = datetime.datetime.now()
print("Year:", now.year)
print("Month:", now.month)
print("Day:", now.day)
print("Hour:", now.hour)
print("Minute:", now.minute)
print("Second:", now.second)

بهذه الطريقة يمكننا معرفة التاريخ والوقت الحاليين واستخدامهما داخل البرنامج.

ملاحظة: الدالة datetime.now() دون تحديد منطقة زمنية تعتمد على الوقت المحلي لبيئة التشغيل التي يعمل عليها البرنامج.

إنشاء تاريخ معين باستخدام date()

يمكننا إنشاء تاريخ محدد بأنفسنا باستخدام الكلاس date.

الصيغة:

date(year, month, day)

مثال:

from datetime import date
my_date = date(2026, 12, 25)
print(my_date)

النتيجة:

2026-12-25

يمكننا استخدام هذا الأسلوب عند التعامل مع تواريخ ثابتة، مثل مواعيد المناسبات أو تواريخ الميلاد أو بداية ونهاية الاشتراكات.

مثال آخر:

from datetime import date
birthday = date(2000, 5, 15)
print("Birthday:", birthday)
print("Year:", birthday.year)

ملاحظة: يجب أن تكون قيم السنة والشهر واليوم صحيحة، وإلا ستظهر رسالة خطأ من نوع ValueError.

التعامل مع الوقت فقط باستخدام time()

إذا أردنا إنشاء وقت محدد دون الحاجة إلى التاريخ، يمكننا استخدام الكلاس time.

الصيغة:

time(hour, minute, second)

مثال:

from datetime import time
my_time = time(14, 30, 45)
print(my_time)

النتيجة:

14:30:45

يمكننا الوصول إلى أجزاء الوقت بشكل منفصل:

from datetime import time
my_time = time(14, 30, 45)
print("Hour:", my_time.hour)
print("Minute:", my_time.minute)
print("Second:", my_time.second)

النتيجة:

Hour: 14
Minute: 30
Second: 45

يمكن أيضًا إنشاء وقت يتضمن أجزاء من الثانية:

from datetime import time
my_time = time(10, 15, 30, 500000)
print(my_time)

النتيجة:

10:15:30.500000

حساب الفرق بين تاريخين باستخدام timedelta()

تُعد timedelta من أهم الأدوات في مكتبة datetime، حيث تسمح لنا بتمثيل فترة زمنية وإجراء عمليات حسابية على التواريخ والأوقات.

يمكن استخدامها لحساب الفرق بين تاريخين أو إضافة أيام وساعات ودقائق إلى تاريخ معين.

مثال لحساب الفرق بين تاريخين:

from datetime import date
date1 = date(2026, 11, 18)
date2 = date(2026, 12, 25)
difference = date2 - date1
print(difference)
print("Days:", difference.days)

النتيجة:

37 days, 0:00:00
Days: 37

تعيد عملية الطرح بين التاريخين كائنًا من النوع timedelta.

إضافة أيام إلى تاريخ معين

يمكننا إضافة أيام إلى تاريخ باستخدام timedelta():

from datetime import date, timedelta
today = date.today()
future_date = today + timedelta(days=10)
print("Today:", today)
print("After 10 days:", future_date)

طرح أيام من تاريخ معين

from datetime import date, timedelta
today = date.today()
past_date = today - timedelta(days=7)
print("Today:", today)
print("7 Days Ago:", past_date)

إضافة ساعات ودقائق وثوانٍ

لا تقتصر timedelta على الأيام فقط، بل يمكن استخدامها مع الساعات والدقائق والثواني.

from datetime import datetime, timedelta
now = datetime.now()
future_time = now + timedelta(
    days=1,
    hours=3,
    minutes=30,
    seconds=15
)
print("Current:", now)
print("Future:", future_time)

يمكننا أيضًا استخدام:

  • weeks: الأسابيع.
  • days: الأيام.
  • hours: الساعات.
  • minutes: الدقائق.
  • seconds: الثواني.
  • milliseconds: أجزاء الألف من الثانية.
  • microseconds: أجزاء المليون من الثانية.

معرفة اليوم من الأسبوع باستخدام weekday()

توفر مكتبة datetime طريقة لمعرفة رقم اليوم من الأسبوع باستخدام weekday().

مثال:

from datetime import date
today = date.today()
print(today.weekday())

تعيد الدالة رقمًا يبدأ من الصفر:

الرقماليوم
0Monday
1Tuesday
2Wednesday
3Thursday
4Friday
5Saturday
6Sunday

إذا أردنا معرفة اسم اليوم مباشرة، يمكننا استخدام strftime():

from datetime import date
today = date.today()
day_name = today.strftime("%A")
print(day_name)

توجد أيضًا الدالة isoweekday()، لكنها تستخدم ترقيمًا مختلفًا:

  • الاثنين = 1.
  • الثلاثاء = 2.
  • ...
  • الأحد = 7.

التعامل مع الطوابع الزمنية Timestamp

الطابع الزمني Timestamp هو قيمة رقمية تمثل عدد الثواني منذ نقطة زمنية مرجعية تُعرف باسم Unix Epoch، وهي:

1970-01-01 00:00:00 UTC

تُستخدم الطوابع الزمنية كثيرًا في التطبيقات وقواعد البيانات وأنظمة تسجيل الأحداث.

يمكننا الحصول على الطابع الزمني الحالي باستخدام timestamp():

from datetime import datetime
now = datetime.now()
timestamp_value = now.timestamp()
print(timestamp_value)

ستظهر قيمة رقمية تختلف حسب وقت التشغيل والمنطقة الزمنية.

تحويل Timestamp إلى تاريخ

يمكننا تحويل الطابع الزمني إلى كائن تاريخ ووقت باستخدام fromtimestamp():

from datetime import datetime
timestamp_value = 1795000000
my_date = datetime.fromtimestamp(timestamp_value)
print(my_date)

تعرض النتيجة التاريخ والوقت المحليين المقابلين للطابع الزمني.

إذا أردنا التحويل إلى توقيت UTC، يمكننا استخدام:

from datetime import datetime, timezone
timestamp_value = 1795000000
my_date = datetime.fromtimestamp(
    timestamp_value,
    tz=timezone.utc
)
print(my_date)

مكتبة time في لغة بايثون

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

لاستخدامها نكتب:

>>>import time

مثال

>>>import time
>>>time.time()
1716101827.5577943

نلاحظ أنه طبع لنا التاريخ و الوقت بشكل seconds, و لعرضه بالطريقة العادية نكتب كالتالي :

>>>import time
>>>time.ctime()
'Sun May 19 09:57:34 2024'

كما لاحظنا أنه طَبَعَ لنا التاريخ و الوقت بشكل نظامي حسب الوقت في الحاسب لدي اما اذا كتبنا كالتالي  :

time.time(time.ctime())

سوف يعطينا الخطأ

Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: time() takes no arguments (1 given)

معنى ذلك أنه يحتاج مننا 1 أرجيومنت و لا يمكن أن نُدخِل time.time و ندخل به أرجيومنت مثل  ctime لأنه غلط لأن ctime هو يأخذ الـ seconds والمفرض يكتب بالشكل التالي كي يعرض لنا التاريخ والوقت

>>>time.ctime(time.time())
'Sun May 19 09:57:34 2024'
>>>time.ctime(1583307387.367132)
'Wed Mar  4 10:57:26 2020'

 

قياس مدة تنفيذ البرنامج باستخدام perf_counter()

إذا أردنا قياس الوقت المستغرق لتنفيذ جزء معين من الكود، يمكننا استخدام perf_counter().

مثال:

import time
start = time.perf_counter()
total = 0
for number in range(1000000):
    total += number
end = time.perf_counter()
execution_time = end - start
print("Execution Time:", execution_time)

تعرض النتيجة المدة المستغرقة لتنفيذ الحلقة بالثواني.

تُعد perf_counter() مناسبة لقياس الأداء ومقارنة سرعة تنفيذ أجزاء مختلفة من البرامج.

تحويل الوقت باستخدام localtime()

تسمح لنا الدالة localtime() بتحويل الطابع الزمني إلى بيانات وقت محلية منظمة.

مثال:

import time
current_time = time.localtime()
print("Year:", current_time.tm_year)
print("Month:", current_time.tm_mon)
print("Day:", current_time.tm_mday)
print("Hour:", current_time.tm_hour)
print("Minute:", current_time.tm_min)
print("Second:", current_time.tm_sec)

تعيد الدالة كائنًا يحتوي على أجزاء التاريخ والوقت بشكل منفصل.

تنسيق الوقت باستخدام strftime() في مكتبة time

هذا التابع يقوم بإنشاء سلسلة نصية تتضمن التاريخ الجاري و التعامل معه و يتم إستخدام معه عدة موجهات.

تحتوي مكتبة time أيضًا على دالة strftime() لتنسيق الوقت.

مثال:
import time
current_time = time.localtime()
formatted_time = time.strftime(
    "%d/%m/%Y %H:%M:%S",
    current_time
)
print(formatted_time)

تعرض النتيجة التاريخ والوقت بالتنسيق المحدد.

سوف نشرح عدة أمثلة التي تتعامل مع strftime.

1- عرض اليوم بإختصار.

>>> time.strftime("%a")
'Wed'

2- عرض اليوم كلمة كاملة.

>>> time.strftime("%A")
'Wednsday'

3- عرض الشهر مختصر.

>>>time.strftime("%b")
'Mar'

4- عرض الشهر كلمة كاملة.

>>>time.strftime("%B")
'March'

5- عرض اليوم و الساعة و التاريخ كامل.

>>>time.strftime("%c")
'Wed Mar 4 10:57:26 2021'

6- عرض اليوم كـ رقم.

>>>time.strftime("%d")
'04'

7- عرض الساعة الحالية بدون دقائق توقيت 24.

>>>time.strftime("%H")
'18'

8- عرض الساعة الحالية بدون دقائق توقيت 12.

>>>time.strftime("%H")
'10'

9- عرض رقم اليوم الحالي من السنة من 001 إلى 365.

>>>time.strftime("%j")
'064'

10- عرض الشهر كـ رقم.

>>>time.strftime("%m")
'03'

11- عرض الدقائق الحالية.

>>>time.strftime("%M")
'27'

12- عرض الوقت صباحي أو مسائي.

>>>time.strftime("%p")
'AM'

13- عرض الثواني الحالية.

>>>time.strftime("%S")
'46'

14- عرض رقم الأسبوع من السنة.

>>>time.strftime("%U")
'09'

15- عرض رقم اليوم من الأسبوع.

>>>time.strftime("%w")
'03'

16- عرض التاريخ الحالي.

>>>time.strftime("%x")
'03/04/20'

17- عرض الوقت الحاليstrftime.

>>>time.strftime("%X")
'10:57:26'

18- عرض السنة بشكل مختصر.

>>>time.strftime("%y")
'20'strftime

19- عرض السنة بشكل طبيعي.

>>>time.strftime("%Y")
'2020'

20- عرض فارق الوقت حسب التوقيت العالمي.

>>>time.strftime("%pZ")
'+03'

21- عرض التاريخ و الوقت كاملاً.

>>> time.strftime("%d:%m:%Y:%H:%M:%S")
'04:03:2020:10:58:42'

تحويل النص إلى تاريخ باستخدام strptime()

هذا التابع يقوم بإنشاء كائن object من سلسلة نصية تُمثّل الوقت و التاريخ بواسطة علامات تنسيق خاصة.

في بعض الأحيان نحصل على التاريخ من المستخدم على شكل نص String، ونحتاج إلى تحويله إلى كائن تاريخ يمكن إجراء العمليات الحسابية عليه.

هنا نستخدم الدالة strptime()، وهي اختصار لـ String Parse Time.

مثال

>>>import time
>>> time.strptime("04 03 2020","%d %m %Y")
#النتيجة result
time.struct_time(tm_year=2020, tm_mon=3, tm_mday=4, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=2, tm_yday=64, tm_isdst=-1)

معنى السؤال أعطيناه يوم و شهر و سنة و بعده اعطيناه رموز دلالاتهن ليميزهن لنا بالإجابة وكما لاحظتم وضع قبل السنة tm_year و قبل الشهر و قبل اليوم و الساعه تركها اصفار 0 لأن لم نطلب منه هذا.

مثال

>>>import time
>>> time.strptime("04 10 2021 12 30 5","%d %m %Y %H %M %S")
time.struct_time(tm_year=2021, tm_mon=10, tm_mday=4, tm_hour=12, tm_min=30, tm_sec=5, tm_wday=0, tm_yday=277, tm_isdst=-1)

 مثال:

from datetime import datetime
date_text = "18/11/2026"
my_date = datetime.strptime(date_text, "%d/%m/%Y")
print(my_date)

النتيجة:

2026-11-18 00:00:00

لاحظ أننا حددنا التنسيق المستخدم في النص من خلال:

"%d/%m/%Y"

يجب أن يتطابق التنسيق مع ترتيب البيانات الموجودة في النص.

مثال آخر

إذا كان التاريخ مكتوبًا بالشكل التالي:

2026-12-25

يمكننا تحويله باستخدام:

from datetime import datetime
date_text = "2026-12-25"
my_date = datetime.strptime(date_text, "%Y-%m-%d")
print(my_date)

معالجة أخطاء التاريخ

إذا أدخل المستخدم تاريخًا غير صحيح أو استخدم تنسيقًا مختلفًا، فقد يظهر خطأ ValueError.

يمكننا معالجة هذا الخطأ باستخدام try وexcept:

from datetime import datetime
date_text = input("Enter date (DD/MM/YYYY): ")
try:
    my_date = datetime.strptime(date_text, "%d/%m/%Y")
    print("Valid date:", my_date)
except ValueError:
    print("Invalid date format")

هذا المثال مفيد عند إنشاء نماذج تسجيل أو برامج تستقبل التواريخ من المستخدم.


الفرق بين strftime() و strptime()

قد يختلط الأمر على المبتدئين بين هاتين الدالتين، لكن الفرق بينهما بسيط:

الدالةالوظيفة
strftime()تحويل التاريخ والوقت إلى نص String
strptime()تحويل النص إلى كائن تاريخ ووقت

مثال على strftime():

from datetime import datetime
now = datetime.now()
date_text = now.strftime("%d/%m/%Y")
print(date_text)

مثال على strptime():

from datetime import datetime
date_text = "18/11/2026"
my_date = datetime.strptime(date_text, "%d/%m/%Y")
print(my_date)

تذكر هذه القاعدة:

  • strftime: من تاريخ إلى نص.
  • strptime: من نص إلى تاريخ.

إستخدام sleep مع الوقت في لغة بايثون

تقوم الدالة sleep() بتعليق كود ( إنتظار كود ) لعدد معين من الثواني يتم تحديدها ويتم إستخدامها في مكتبة time. لفهم معنى sleep بشكل أوضح سوف نأخذ المثال الآتي مستخدمين به مكتبة sleep.

تُستخدم الدالة sleep() لإيقاف تنفيذ البرنامج لمدة زمنية محددة بالثواني.

import time
print("Start")
time.sleep(3)
print("End")

في هذا المثال سيتوقف البرنامج لمدة 3 ثوانٍ قبل طباعة كلمة End.

يمكن استخدام أجزاء من الثانية أيضًا:

import time
print("Waiting...")
time.sleep(0.5)
print("Done")

مثال

import time
def sleepwithloop () :
    for i in range (10) :
        time.sleep (2)
        print (i)
#تشغيل الكود بمناداة الدالة بإسمها
sleepwithloop()    #مناداة الدالة للتشغيل
0
1
2
3
4
5
6
7
8
9

سوف يطبع لنا الأرقام من 0 حتى 9 لكن بين طباعة كل رقم ينتظر ثانيتين و يطبع الرقم الذي يليه و يتوقف عند الرقم 9.

مكتبة calendar للتعامل مع التقويم

توفر Python مكتبة calendar التي تساعدنا على التعامل مع التقويم، وعرض الأشهر والسنوات ومعرفة عدد الأيام في الشهر.

نبدأ باستيراد المكتبة:

import calendar

عرض تقويم شهر معين باستخدام month()

يمكننا عرض تقويم شهر وسنة محددين باستخدام month().

مثال:

import calendar
print(calendar.month(2026, 11))

ستظهر نتيجة تحتوي على أيام الشهر مرتبة حسب أيام الأسبوع.

2. عرض تقويم سنة كاملة باستخدام calendar()

إذا أردنا عرض تقويم سنة كاملة، نستخدم:

import calendar
print(calendar.calendar(2026))

سيعرض البرنامج جميع أشهر السنة المحددة.

3. معرفة عدد أيام الشهر باستخدام monthrange()

تُستخدم الدالة monthrange() لمعرفة يوم بداية الشهر وعدد أيامه.

مثال:

import calendar
result = calendar.monthrange(2026, 11)
print(result)

تعيد الدالة قيمتين:

  1. رقم يوم الأسبوع الذي يبدأ به الشهر، وفق ترقيم يبدأ من الاثنين بصفر.
  2. عدد أيام الشهر.

إذا أردنا معرفة عدد الأيام فقط:

import calendar
days = calendar.monthrange(2026, 11)[1]
print("Days in month:", days)

النتيجة:

Days in month: 30

4. التحقق من السنة الكبيسة باستخدام isleap()

السنة الكبيسة هي السنة التي تحتوي على 366 يومًا بدلًا من 365 يومًا.

يمكننا التحقق منها باستخدام isleap().

مثال:

import calendar
year = 2028
if calendar.isleap(year):
    print("Leap Year")
else:
    print("Not a Leap Year")

النتيجة:

Leap Year

5. حساب عدد السنوات الكبيسة باستخدام leapdays()

يمكننا معرفة عدد السنوات الكبيسة بين سنتين باستخدام leapdays().

مثال:

import calendar
result = calendar.leapdays(2020, 2030)
print(result)

تحسب الدالة السنوات الكبيسة ضمن النطاق الذي يبدأ بالسنة الأولى وينتهي قبل السنة الثانية.

التعامل مع المناطق الزمنية Time Zones

عند تطوير التطبيقات التي تعمل مع مستخدمين من دول مختلفة، قد نحتاج إلى التعامل مع المناطق الزمنية.

فمثلًا، قد يكون الوقت في بلد ما مختلفًا عن الوقت في بلد آخر، لذلك من المهم أن نعرف كيف نتعامل مع الوقت المحلي ووقت UTC.

1. ما هو UTC؟

UTC هو التوقيت العالمي المنسق، ويُستخدم كمرجع موحد لحساب الوقت حول العالم.

يمكننا الحصول على الوقت الحالي بتوقيت UTC باستخدام datetime وtimezone:

from datetime import datetime, timezone
utc_now = datetime.now(timezone.utc)
print(utc_now)

استخدام timezone.utc يجعل التاريخ والوقت مرتبطين بمنطقة زمنية محددة، بدلًا من أن يكونا وقتًا محليًا دون معلومات عن المنطقة الزمنية.

2. الفرق بين الوقت Aware وNaive

في Python يوجد نوعان من كائنات التاريخ والوقت:

Naive Datetime: كائن لا يحتوي على معلومات تحدد المنطقة الزمنية التي ينتمي إليها.

مثال:

from datetime import datetime
now = datetime.now()
print(now)

Aware Datetime: كائن يحتوي على معلومات المنطقة الزمنية.

مثال:

from datetime import datetime, timezone
now = datetime.now(timezone.utc)
print(now)

من الأفضل استخدام كائنات Aware عند التعامل مع مواعيد وأحداث تتعلق بأكثر من منطقة زمنية، لتجنب الالتباس في حساب الوقت.

3. استخدام ZoneInfo للتعامل مع المناطق الزمنية

توفر Python مكتبة zoneinfo منذ الإصدار 3.9، وتسمح بالتعامل مع المناطق الزمنية باستخدام أسمائها المعروفة.

مثال للحصول على الوقت في القاهرة:

from datetime import datetime
from zoneinfo import ZoneInfo
cairo_time = datetime.now(ZoneInfo("Africa/Cairo"))
print(cairo_time)

ومثال للحصول على الوقت في لندن:

from datetime import datetime
from zoneinfo import ZoneInfo
london_time = datetime.now(ZoneInfo("Europe/London"))
print(london_time)

يمكنك استخدام أسماء مناطق زمنية أخرى، مثل:

  • Asia/Riyadh
  • Asia/Dubai
  • Europe/Amsterdam
  • America/New_York
  • Asia/Tokyo

تتولى ZoneInfo التعامل مع قواعد التوقيت الصيفي والتغييرات الزمنية المعروفة للمنطقة.

ملاحظة: في بعض أنظمة Windows أو البيئات التي لا تتوفر فيها قاعدة بيانات المناطق الزمنية، قد تحتاج إلى تثبيت حزمة tzdata:

pip install tzdata

تطبيق عملي حساب العمر باستخدام تاريخ الميلاد

بعد أن تعرفنا على أهم أدوات التعامل مع التاريخ والوقت، لننفذ تطبيقًا بسيطًا يقوم بحساب عمر المستخدم اعتمادًا على تاريخ ميلاده.

سنستخدم datetime لاستقبال التاريخ وحساب الفرق بينه وبين تاريخ اليوم.

from datetime import date, datetime
birthday_text = input("Enter your birthday (DD/MM/YYYY): ")
try:
    birthday = datetime.strptime(
        birthday_text,
        "%d/%m/%Y"
    ).date()
    today = date.today()
    if birthday > today:
        print("Birthday cannot be in the future")
    else:
        age = today.year - birthday.year
        if (today.month, today.day) < (birthday.month, birthday.day):
            age -= 1
        print("Your age is:", age)
except ValueError:
    print("Please enter a valid date")

كيف يعمل البرنامج؟

  1. يطلب من المستخدم إدخال تاريخ ميلاده.
  2. يحول النص إلى تاريخ باستخدام strptime().
  3. يحصل على تاريخ اليوم باستخدام date.today().
  4. يحسب الفرق بين السنتين.
  5. يتحقق مما إذا كان عيد الميلاد قد مر خلال السنة الحالية.
  6. يعرض العمر بالسنوات.
  7. يعالج أخطاء إدخال التاريخ.

هذا التطبيق مثال بسيط على كيفية استخدام التاريخ والوقت في البرامج الحقيقية.

تطبيق عملي – إنشاء ساعة رقمية بسيطة

يمكننا استخدام مكتبة time لإنشاء ساعة رقمية تعرض الوقت الحالي وتتحدث كل ثانية.

import time
while True:
    current_time = time.strftime("%H:%M:%S")
    print(current_time, end="\r")
    time.sleep(1)

شرح الكود

  • استخدمنا حلقة while True لتكرار العملية باستمرار.
  • استخدمنا time.strftime() للحصول على الوقت الحالي.
  • استخدمنا end="\r" للعودة إلى بداية السطر وتحديث الوقت في المكان نفسه.
  • استخدمنا time.sleep(1) لإيقاف التنفيذ لمدة ثانية قبل التحديث التالي.

لإيقاف الساعة، اضغط على Ctrl + C داخل Terminal.

أخطاء شائعة عند التعامل مع التاريخ والوقت

هناك بعض الأخطاء التي قد تواجه المبتدئين أثناء استخدام مكتبات التاريخ والوقت في Python.

1. استخدام تنسيق غير صحيح مع strptime()

مثال:

from datetime import datetime
date_text = "18/11/2026"
my_date = datetime.strptime(date_text, "%Y-%m-%d")

سيحدث خطأ لأن تنسيق النص لا يتوافق مع التنسيق المحدد.

الحل: استخدم التنسيق الصحيح:

my_date = datetime.strptime(date_text, "%d/%m/%Y")

2. محاولة استخدام قيمة نصية في العمليات الحسابية

مثال:

date1 = "2026-11-18"
date2 = "2026-12-25"
print(date2 - date1)

لا يمكن طرح نص من نص بهذه الطريقة للحصول على الفرق الزمني.

الحل: حول النصوص إلى كائنات تاريخ باستخدام strptime() أولًا.

3. نسيان معالجة التاريخ غير الصحيح

إذا أدخل المستخدم تاريخًا غير صالح، مثل اليوم 35 من الشهر، ستظهر رسالة ValueError.

الحل: استخدم try وexcept للتحقق من صحة البيانات ومعالجة الأخطاء.

4. الخلط بين الوقت المحلي وUTC

قد تحصل على نتائج غير صحيحة عند مقارنة أوقات من مناطق زمنية مختلفة إذا لم تحدد المنطقة الزمنية.

الحل: استخدم كائنات Aware Datetime عند التعامل مع مناطق زمنية متعددة، ويفضل تخزين الأوقات المهمة بتوقيت UTC ثم تحويلها إلى التوقيت المحلي عند عرضها.

5. الخلط بين strftime وstrptime

تذكر دائمًا:

  • strftime() لتحويل التاريخ إلى نص.
  • strptime() لتحويل النص إلى تاريخ.

تمارين عملية على التاريخ والوقت في بايثون

بعد الانتهاء من هذا الدرس، حاول تنفيذ التمارين التالية بنفسك:

التمرين الأول: اكتب برنامجًا يعرض تاريخ اليوم والوقت الحالي باستخدام datetime.now().

التمرين الثاني: اكتب برنامجًا يعرض التاريخ بالتنسيق التالي: يوم/شهر/سنة باستخدام strftime().

التمرين الثالث: اكتب برنامجًا يستقبل تاريخ ميلاد المستخدم، ثم يحوله إلى كائن تاريخ باستخدام strptime().

التمرين الرابع: اكتب برنامجًا يحسب عدد الأيام المتبقية حتى تاريخ معين باستخدام timedelta.

التمرين الخامس: اكتب برنامجًا يعرض اسم اليوم الحالي باللغة الإنجليزية باستخدام strftime().

التمرين السادس: اكتب برنامجًا يتحقق مما إذا كانت سنة معينة كبيسة باستخدام calendar.isleap().

التمرين السابع: اكتب برنامجًا يعرض الوقت الحالي في مدينتين مختلفتين باستخدام ZoneInfo.

التمرين الثامن: أنشئ ساعة رقمية بسيطة باستخدام time.sleep() وtime.strftime().

حاول حل هذه التمارين بنفسك، ولا تكتفِ بنسخ الأكواد، لأن التطبيق العملي هو أفضل طريقة لتثبيت المعلومات.

تعرفنا في هذا المقال على كيفية التعامل مع التاريخ والوقت في لغة Python باستخدام المكتبات المدمجة datetime وtime وcalendar.

تعلمنا كيفية الحصول على التاريخ والوقت الحاليين، وإنشاء تواريخ وأوقات محددة، وتنسيقها باستخدام strftime()، وتحويل النصوص إلى تواريخ باستخدام strptime()، وحساب الفرق بين التواريخ وإضافة الأيام والساعات باستخدام timedelta().

كما تعرفنا على الطوابع الزمنية Timestamp، وقياس مدة تنفيذ البرامج، وعرض التقويم، والتحقق من السنوات الكبيسة، والتعامل مع المناطق الزمنية باستخدام ZoneInfo.

تُعد هذه الأدوات من المهارات المهمة التي ستحتاج إليها عند تطوير تطبيقات حقيقية باستخدام Python، مثل أنظمة الحجز والمواعيد، وبرامج إدارة الموظفين، والتقارير، وأنظمة تسجيل الأحداث.

في الدرس القادم سنتعرف على مكتبة random في لغة بايثون، وسنتعلم كيفية توليد الأرقام العشوائية واختيار عناصر عشوائية من القوائم وخلط العناصر، مع أمثلة وتطبيقات عملية.

google-playkhamsatmostaqltradentX