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

مقدمة

بايثون تحتوي على أكثر من موديول جاهز للتعامل مع التاريخ, الوقت و التقويم بكل سهولة.
في هذا الدرس ستتعلم طريقة الإستفادة من الموديول datetime و الموديول calendar لعرض التاريخ, الوقت و التقويم بالشكل الذي تحتاجه.

الموديول `datetime`

الموديول datetime يحتوي على مجموعة كلاسات فيها دوال جاهزة للتعامل مع التاريخ و الوقت.

date: يحتوي على مجموعة دوال خاصة للتعامل مع التاريخ.
time: يحتوي على مجموعة دوال خاصة للتعامل مع الوقت.
datetime: يحتوي على مجموعة دوال خاصة للتعامل مع التاريخ و الوقت.
timedelta: يحتوي على مجموعة دوال خاصة لحساب الفرق بدقة بين تاريخ و آخر.
timezone: يحتوي على مجموعة دوال خاصة لحساب فرق التوقيت بين تاريخ و آخر على حسب المنطقة الزمنية لكل تاريخ.

في المثال التالي قمنا بتخزين التاريخ و الوقت الحالي بالإعتماد على الدالة now() الموجودة في الكلاس datetime الموجود بداخل الموديول datetime.

المثال الأول

Test.py

# datetime هنا قمنا بتضمين كل محتوى الموديول
import datetime

# dt في الكائن datetime ككائن من الكلاس now() هنا قمنا بتخزين التاريخ و الوقت الحالي الذي سترجعه الدالة
dt = datetime.datetime.now()

# dt هنا قمنا بعرض قيمة الكائن
print(dt)

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

2018-12-01 09:13:09.598797

نلاحظ من المثال السابق أن الكلاس datetime يتيح لنا الحصول على التاريخ و الوقت بدقة عالية لأنه أعطانا المعلومات التالية بالترتيب:
السنة, الشهر, اليوم, الساعة, الدقيقة, الثانية, أجزاء الثانية القادمة.

طبعاً الكلاس datetime يحتوي على دوال و خصائص جاهزة تتيح لك التعامل مع التاريخ و الوقت كيفما شئت لتخزينه أو عرضه بالشكل الذي تريد.
لا تقلق سنتعرف على خصائص و دوال الكلاس datetime بتفصيل في هذا الدرس.

كونستركتور الكلاس `datetime`

الكلاس datetime يحتوي على الكونستركتور التالي.

class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)

إذاً, عند إنشاء كائن datetime, يمكنك مباشرةً أن تدخل تاريخ و وقت فيه.

فعلياً, أنت مجبر على إدخال قيمة مكان البارميترات year و month و day لأنه لم يتم إعطائهم قيم إفتراضية.
بالنسبة للباراميترات الأخرى فيمكنك تحديد قيمهم الإفتراضية أو عدم تحديدها لأنه تم إعطائهم قيم إفتراضية.

القيم التي يمكنك تمريرها للبارميترات هي التالية:

year: عدد صحيح قيمته ضمن النطاق 1 <= year <= 9999.
month: عدد صحيح قيمته ضمن النطاق 1 <= year <= 12.
day: عدد صحيح قيمته بين 1 و آخر يوم موجود في الشهر.
hour: عدد صحيح قيمته ضمن النطاق 0 <= year < 24.
minute: عدد صحيح قيمته ضمن النطاق 0 <= year < 60.
second: عدد صحيح قيمته ضمن النطاق 0 <= year < 60.
microsecond: عدد صحيح قيمته ضمن النطاق 0 <= year < 1000000.
fold: عدد صحيح قيمته 0 أو 1.

في حال قمت بتمرير أي قيمة للباراميترات خارجة عن النطاق المسموح سيحدث خطأ ValueError.

في المثال التالي قمنا بإنشاء كائن من الكلاس datetime مع تحديد التاريخ الذي نريد تخزينه فيه مباشرةً عند إنشاءه.

المثال الأول

Test.py

# datetime هنا قمنا بتضمين كل محتوى الموديول
import datetime

# dt يمثل تاريخ محدد و قمنا بتخزينه في الكائن datetime هنا قمنا بإنشاء كائن من الكلاس
dt = datetime.datetime(2012, 4, 5)

# dt هنا قمنا بعرض قيمة الكائن
print(dt)

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

2012-04-05 00:00:00

في المثال التالي قمنا بإنشاء كائن من الكلاس datetime مع تحديد التاريخ و الوقت الذي نريد تخزينه فيه مباشرةً عند إنشاءه.

المثال الثاني

Test.py

# datetime هنا قمنا بتضمين كل محتوى الموديول
import datetime

# dt يمثل تاريخ + وقت محدد و قمنا بتخزينه في الكائن datetime هنا قمنا بإنشاء كائن من الكلاس
dt = datetime.datetime(2012, 4, 5, 7, 30, 46)

# dt هنا قمنا بعرض قيمة الكائن
print(dt)

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

2012-04-05 07:30:46

خصائص الكلاس `datetime`

الجدول التالي يحتوي على خصائص الكلاس datetime الموجود في الموديول datetime.

إسم الثابت	تعريفه
`year`	يحتوي على رقم السنة المخزن في كائن الـ`datetime`.
`month`	يحتوي على رقم الشهر المخزن في كائن الـ`datetime`.
`day`	يحتوي على رقم اليوم المخزن في كائن الـ`datetime`.
`hour`	يحتوي على رقم الساعة المخزن في كائن الـ`datetime`.
`minute`	يحتوي على رقم الدقائق المخزن في كائن الـ`datetime`.
`second`	يحتوي على رقم الثواني المخزن في كائن الـ`datetime`.
`microsecond`	يحتوي على رقم أجزاء الثواني المخزن في كائن الـ`datetime`.

في المثال التالي قمنا بعرض السنة فقط من التاريخ المخزن في كائن الـ datetime بالإعتماد على الخاصية year.

مثال

Test.py

# datetime هنا قمنا بتضمين كل محتوى الموديول
import datetime

# dt في الكائن datetime ككائن من الكلاس now() هنا قمنا بتخزين التاريخ و الوقت الحالي الذي سترجعه الدالة
dt = datetime.datetime.now()

# dt الموجودة في الكائن year هنا قمنا بعرض قيمة الخاصية
print('This tutorial is written in', dt.year)

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

This tutorial is written in 2018

تحديد فورمات التاريخ و الوقت

في البداية, المقصود بتحديد فورمات ( Format ) التاريخ و الوقت هو عرضه أو تخزينه أو بشكل مختلف.

لتحديد فورمات التاريخ و الوقت الذي نريد إظهاره نستخدم دالة جاهزة في الكلاس datetime إسمها strftime().
إستخدام هذه الدالة سهل جداً, حيث نستدعيها من كائن الـ datetime و من ثم نمرر لها رمز أو مجموعة رموز منفصلة لتحديد الأشياء التي نريدها أن ترجعهم لنا كنص.

في المثال التالي قمنا بالإعتماد على الدالة strftime() الموجودة في الكلاس datetime لعرض إسم الشهر الحالي.

مثال

Test.py

# datetime هنا قمنا بتضمين كل محتوى الموديول
import datetime

# dt في الكائن datetime ككائن من الكلاس now() هنا قمنا بتخزين التاريخ و الوقت الحالي الذي سترجعه الدالة
dt = datetime.datetime.now()

# و من ثم قمنا بطباعته dt لها كنص حتى ترجع إسم الشهر المخزن في الكائن %B و تمرير الرمز strftime() هنا قمنا باستدعاء الدالة
print(dt.strftime('%B'))

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

December

الرموز التي يمكن إستخدامها في الدالة `strftime()`

الجدوال التالي يحتوي على الرموز التي يمكنك إستخدامها عند تحديد فورمات التاريخ و الوقت باستخدام الدالة strftime().

الرمز	إستخدامه	مثال	مثال شامل
`%a`	لإظهار إسم اليوم بشكل مختصر	`Mon`	شاهد المثال
`%A`	لإظهار إسم اليوم بشكل كامل	`Monday`	شاهد المثال
`%w`	لإظهار رقم اليوم بالنسبة للأسبوع. هنا أول يوم يعتبر يوم الأحد ( Sunday ) و هو يساوي 0, و آخر يوم في الأسبوع هو يوم السبت ( Saturday ) و هو يساوي 6	`1`	شاهد المثال
`%d`	لإظهار رقم اليوم بالنسبة للشهر, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق `01 - 31`	`03`	شاهد المثال
`%b`	لإظهار إسم الشهر بشكل مختصر	`Dec`	شاهد المثال
`%B`	لإظهار إسم الشهر كاملاَ	`December`	شاهد المثال
`%m`	لإظهار رقم الشهر بالنسبة للسنة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق `01 - 12`	`12`	شاهد المثال
`%y`	لإظهار رقم السنة بشكل مختصر, أي لإظهار أول رقمين منها فقط.	`18`	شاهد المثال
`%Y`	لإظهار رقم السنة.	`2018`	شاهد المثال
`%H`	لإظهار رقم الساعة بنظام 24 ساعة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق `00 - 23`	`14`	شاهد المثال
`%I`	لإظهار رقم الساعة بنظام 12 ساعة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق `00 - 11`	`2`	شاهد المثال
`%p`	لإظهار كلمة `AM` إذا كان الوقت قبل الساعة 12 نهاراً و لإظهار كلمة `PM` إذا كان الوقت بعدها	`PM`	شاهد المثال
`%M`	لإظهار رقم الدقيقة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق `00 - 59`	`24`	شاهد المثال
`%S`	لإظهار رقم الثانية, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق `00 - 59`	`09`	شاهد المثال
`%f`	لإظهار أجزاء الثانية بالـ Microsecond, أي لإظهار الثانية الواحدة كمليون جزء. مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق `000000 - 999999`	`034208`	شاهد المثال
`%j`	لإظهار رقم اليوم بالنسبة للسنة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق `001 - 366`	`337`	شاهد المثال
`%U`	لإظهار رقم الأسبوع بالنسبة للسنة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق `00 - 53` و أول يوم في كل أسبوع هو يوم الأحد ( Sunday )	`48`	شاهد المثال
`%W`	لإظهار رقم الأسبوع بالنسبة للسنة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق `00 - 53` و أول يوم في كل أسبوع هو يوم الإثنين ( Monday )	`49`	شاهد المثال
`%c`	لإظهار التاريخ و الوقت الحالي بشكل كامل	`Mon Dec 3 18:52:05 2018`	شاهد المثال
`%x`	لإظهار التاريخ الحالي بشكل كامل	`12/03/18`	شاهد المثال
`%X`	لإظهار الوقت الحالي بشكل كامل	`18:52:05`	شاهد المثال

الموديول `calendar`

الموديول calendar يحتوي على مجموعة كلاسات و دوال جاهزة للتعامل مع التقويم و لعرضه بشكل جميل جداً.
فمثلاً, يحتوي على دوال جاهزة لعرض تقويم سنة معينة أو شهر محدد في السنة.

في المثال التالي قمنا بعرض تقويم سنة 2018 بالإعتماد على الدالة prcal() الموجودة في الكلاس calendar الموجود بداخل الموديول calendar.

المثال الأول

Test.py

# calendar هنا قمنا بتضمين كل محتوى الموديول
import calendar

# لعرض تقويم سنة 2018 calendar من الكلاس prcal() هنا قمنا باستدعاء الدالة
calendar.prcal(2018)

سنحصل على النتيجة التالية عند التشغيل.

                                  2018

      January                   February                   March
Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
 1  2  3  4  5  6  7                1  2  3  4                1  2  3  4
 8  9 10 11 12 13 14       5  6  7  8  9 10 11       5  6  7  8  9 10 11
15 16 17 18 19 20 21      12 13 14 15 16 17 18      12 13 14 15 16 17 18
22 23 24 25 26 27 28      19 20 21 22 23 24 25      19 20 21 22 23 24 25
29 30 31                  26 27 28                  26 27 28 29 30 31

       April                      May                       June
Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
                   1          1  2  3  4  5  6                   1  2  3
 2  3  4  5  6  7  8       7  8  9 10 11 12 13       4  5  6  7  8  9 10
 9 10 11 12 13 14 15      14 15 16 17 18 19 20      11 12 13 14 15 16 17
16 17 18 19 20 21 22      21 22 23 24 25 26 27      18 19 20 21 22 23 24
23 24 25 26 27 28 29      28 29 30 31               25 26 27 28 29 30
30

        July                     August                  September
Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
                   1             1  2  3  4  5                      1  2
 2  3  4  5  6  7  8       6  7  8  9 10 11 12       3  4  5  6  7  8  9
 9 10 11 12 13 14 15      13 14 15 16 17 18 19      10 11 12 13 14 15 16
16 17 18 19 20 21 22      20 21 22 23 24 25 26      17 18 19 20 21 22 23
23 24 25 26 27 28 29      27 28 29 30 31            24 25 26 27 28 29 30
30 31

      October                   November                  December
Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
 1  2  3  4  5  6  7                1  2  3  4                      1  2
 8  9 10 11 12 13 14       5  6  7  8  9 10 11       3  4  5  6  7  8  9
15 16 17 18 19 20 21      12 13 14 15 16 17 18      10 11 12 13 14 15 16
22 23 24 25 26 27 28      19 20 21 22 23 24 25      17 18 19 20 21 22 23
29 30 31                  26 27 28 29 30            24 25 26 27 28 29 30
                                                    31

دوال الكلاس `calendar`

الجدول التالي يحتوي على دوال الكلاس calendar الأكثر إستخداماً.

إسم الدالة مع تعريفها
`calendar.prcal(year, w=0, l=0, c=6, m=3)` تستخدم لطباعة تقويم سنة معينة. مكان الباراميتر `year` نمرر السنة التي نريد طباعة تقويمها. شاهد المثال
`calendar.isleap(year)` تستخدم لمعرفة ما إذا كانت السنة كبيسة أم لا. مكان الباراميتر `year` نمرر رقم السنة التي نريد التشييك عليها. في حال كانت قيمة `year` تمثل سنة كبيسة ترجع `True`, إن لم تكن كذلك ترجع `False`. شاهد المثال
`calendar.leapdays(y1, y2)` ترجع عدد السنوات الكبيسة الموجودة من سنة إلى سنة محددة. مكان الباراميتر `y1` نمرر رقم السنة التي نريد أن نبدأ من عندها. مكان الباراميتر `y2` نمرر رقم السنة التي نريد أن نتوقف قبلها. شاهد المثال
`calendar.setfirstweekday(weekday)` إفتراضياً, عند عرض التقويم فإنه يظهر يوم الإثنين ( Monday ) كأول يوم في الأسبوع. هذه الدالة تستخدم لتحديد أول يوم سيبدأ به كل أسبوع. مكان الباراميتر `weekday` نمرر إحدى ثوابت الكلاس `calendar` التي تشير إلى إسم اليوم أو Index الثابت: `calendar.MONDAY` أو 0 لتعيين الإثنين كأول يوم في الأسبوع. `calendar.TUESDAY` أو 1 لتعيين الثلاثاء كأول يوم في الأسبوع. `calendar.WEDNESDAY` أو 2 لتعيين الأربعاء كأول يوم في الأسبوع. `calendar.THURSDAY` أو 3 لتعيين الخميس كأول يوم في الأسبوع. `calendar.FRIDAY` أو 4 لتعيين الجمعة كأول يوم في الأسبوع. `calendar.SATURDAY` أو 5 لتعيين السبت كأول يوم في الأسبوع. `calendar.SUNDAY` أو 6 لتعيين الأحد كأول يوم في الأسبوع. شاهد المثال

الدرس التالي» «الدرس السابق

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

مقدمة

الموديول `datetime`

المثال الأول

كونستركتور الكلاس `datetime`

المثال الأول

المثال الثاني

خصائص الكلاس `datetime`

مثال

تحديد فورمات التاريخ و الوقت

مثال

الرموز التي يمكن إستخدامها في الدالة `strftime()`

الموديول `calendar`

المثال الأول

دوال الكلاس `calendar`

هدف الموقع

روابط مهمة

حقوق النشر

الدورات

أدوات مساعدة

أقسام الموقع

إبحث

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

مقدمة

الموديول datetime

المثال الأول

كونستركتور الكلاس datetime

المثال الأول

المثال الثاني

خصائص الكلاس datetime

مثال

تحديد فورمات التاريخ و الوقت

مثال

الرموز التي يمكن إستخدامها في الدالة strftime()

الموديول calendar

المثال الأول

دوال الكلاس calendar

هدف الموقع

روابط مهمة

حقوق النشر

الدورات

أدوات مساعدة

أقسام الموقع

إبحث

الموديول `datetime`

كونستركتور الكلاس `datetime`

خصائص الكلاس `datetime`

الرموز التي يمكن إستخدامها في الدالة `strftime()`

الموديول `calendar`

دوال الكلاس `calendar`