التعامل مع التاريخ و الوقت في بايثون | Python datetime and calendar

 التاريخ و الوقت في بايثون

مقدمة

بايثون تحتوي على أكثر من مويدويل جاهز للتعامل مع التاريخ, الوقت و التقويم بكل سهولة.
في هذا الدرس ستتعلم طريقة الإستفادة من الموديول 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

Python الرموز التي يمكن إستخدامها في الدالة 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

أمثلة شامله لكل رمز موجود في الجدول

Python datetime.strftime('%a')

في المثال التالي سنمرر الرمز %a كنص للدالة strftime() لإظهار إسم اليوم بشكل مختصر.

مثال

Test.py

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

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

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

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

Mon

Python datetime.strftime('%A')

في المثال التالي سنمرر الرمز %A كنص للدالة strftime() لإظهار إسم اليوم.

مثال

Test.py

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

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

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

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

Monday

Python datetime.strftime('%w')

في المثال التالي سنمرر الرمز %w كنص للدالة strftime() لإظهار رقم اليوم بالنسبة للأسبوع.
ملاحظة: هنا أول يوم يعتبر يوم الأحد ( Sunday ) و هو يساوي 0, و آخر يوم في الأسبوع هو يوم السبت ( Saturday ) و هو يساوي 6

مثال

Test.py

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

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

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

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

1

Python datetime.strftime('%d')

في المثال التالي سنمرر الرمز %d كنص للدالة strftime() لإظهار رقم اليوم بالنسبة للشهر, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق 01 - 31

مثال

Test.py

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

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

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

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

03

Python datetime.strftime('%b')

في المثال التالي سنمرر الرمز %b كنص للدالة strftime() لإظهار إسم الشهر بشكل مختصر.

مثال

Test.py

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

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

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

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

Dec

Python datetime.strftime('%B')

في المثال التالي سنمرر الرمز %B كنص للدالة strftime() لإظهار إسم الشهر.

مثال

Test.py

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

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

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

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

December

Python datetime.strftime('%m')

في المثال التالي سنمرر الرمز %m كنص للدالة strftime() لإظهار رقم الشهر بالنسبة للسنة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق 01 - 12

مثال

Test.py

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

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

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

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

12

Python datetime.strftime('%y')

في المثال التالي سنمرر الرمز %y كنص للدالة strftime() لإظهار رقم السنة بشكل مختصر, أي لإظهار أول رقمين منها فقط.

مثال

Test.py

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

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

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

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

18

Python datetime.strftime('%Y')

في المثال التالي سنمرر الرمز %Y كنص للدالة strftime() لإظهار رقم السنة.

مثال

Test.py

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

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

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

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

2018

Python datetime.strftime('%H')

في المثال التالي سنمرر الرمز %H كنص للدالة strftime() لإظهار رقم الساعة بنظام 24 ساعة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق 00 - 23

مثال

Test.py

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

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

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

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

14

Python datetime.strftime('%I')

في المثال التالي سنمرر الرمز %I كنص للدالة strftime() لإظهار رقم الساعة بنظام 12 ساعة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق 00 - 11

مثال

Test.py

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

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

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

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

02

Python datetime.strftime('%p')

في المثال التالي سنمرر الرمز %p كنص للدالة strftime() لإظهار كلمة AM إذا كان الوقت قبل الساعة 12 نهاراً و لإظهار كلمة PM إذا كان الوقت بعدها.

مثال

Test.py

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

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

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

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

PM

Python datetime.strftime('%M')

في المثال التالي سنمرر الرمز %M كنص للدالة strftime() لإظهار رقم الدقيقة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق 00 - 59.

مثال

Test.py

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

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

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

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

24

Python datetime.strftime('%S')

في المثال التالي سنمرر الرمز %S كنص للدالة strftime() لإظهار رقم الثانية, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق 00 - 59.

مثال

Test.py

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

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

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

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

09

Python datetime.strftime('%f')

في المثال التالي سنمرر الرمز %f كنص للدالة strftime() لإظهار أجزاء الثانية بالـ Microsecond, أي لإظهار الثانية الواحدة كمليون جزء. مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق 000000 - 999999.

مثال

Test.py

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

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

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

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

034208

Python datetime.strftime('%j')

في المثال التالي سنمرر الرمز %j كنص للدالة strftime() لإظهار رقم اليوم بالنسبة للسنة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق 001 - 366

مثال

Test.py

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

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

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

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

337

Python datetime.strftime('%U')

في المثال التالي سنمرر الرمز %U كنص للدالة strftime() لإظهار رقم الأسبوع بالنسبة للسنة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق 00 - 53 و أول يوم في كل أسبوع هو يوم الإثنين ( Monday ).

مثال

Test.py

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

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

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

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

48

Python datetime.strftime('%W')

في المثال التالي سنمرر الرمز %W كنص للدالة strftime() لإظهار رقم الأسبوع بالنسبة للسنة, مع الأخذ بالإعتبار أن هذا الرقم سيكون ضمن النطاق 00 - 53 و أول يوم في كل أسبوع هو يوم الأحد ( Sunday ).

مثال

Test.py

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

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

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

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

49

Python datetime.strftime('%c')

في المثال التالي سنمرر الرمز %c كنص للدالة strftime() لإظهار التاريخ و الوقت الحالي بشكل كامل.

مثال

Test.py

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

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

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

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

Mon Dec  3 15:40:31 2018

Python datetime.strftime('%x')

في المثال التالي سنمرر الرمز %x كنص للدالة strftime() لإظهار التاريخ الحالي بشكل كامل.

مثال

Test.py

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

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

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

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

12/03/18

Python datetime.strftime('%X')

في المثال التالي سنمرر الرمز %X كنص للدالة strftime() لإظهار الوقت الحالي بشكل كامل.

مثال

Test.py

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

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

                    # بشكل كامل و من ثم قمنا بطباعته dt لها كنص حتى ترجع الوقت الحالي المخزن في الكائن %X و تمرير الرمز strftime() هنا قمنا باستدعاء الدالة
                    print(dt.strftime('%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
		

Python دوال الكلاس 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 لتعيين الأحد كأول يوم في الأسبوع.

Python الدالة prcal()

تعريفها

تستخدم لطباعة تقويم سنة معينة.

بناؤها

                  prcal.calendar(year, w=0, l=0, c=6, m=3)
                

باراميترات

• الباراميتر year نمرر له رقم يمثل السنة التي نريد طباعة تقويمها.

• الباراميتر w يمكنك أن تغير قيمته الإفتراضية لتحديد حجم المسافة الفارغة بين كل يومين في التقويم.

• الباراميتر l يمكنك أن تغير قيمته الإفتراضية لتحديد عدد الأسطر الفارغة تحت كل شهر في التقويم.

• الباراميتر c يمكنك أن تغير قيمته الإفتراضية لتحديد حجم المسافة الفارغة بين كل شهرين في التقويم.

• الباراميتر m يمكنك أن تغير قيمته الإفتراضية لتحديد تقويم كل شهر سيتم عرض على نفس المستوى لأنه إفتراضياً يتم عرض تقويم كل ثلاثة أشهر بجانب بعضهم.

قيمة الإرجاع

لا ترجع قيمة.

المثال الأول

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
                  

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

Test.py

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

                    # لعرض تقويم سنة 2018. مع تحديد أننا نريد عرض كل 4 أشهر بجانب بعض calendar من الكلاس prcal() هنا قمنا باستدعاء الدالة
                    calendar.prcal(2018, m=4)
                  

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

                    2018

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

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

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

Python الدالة isleap()

تعريفها

تستخدم لمعرفة ما إذا كانت السنة كبيسة أم لا.

بناؤها

                  calendar.isleap(year)
                

باراميترات

year نمرر مكانه رقم يمثل السنة التي نريد معرفة إن كانت كبيسة أم لا.

قيمة الإرجاع

ترجع True في حال كانت قيمة year تمثل سنة كبيسة.
غير ذلك ترجع False.

مثال

Test.py

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

                    # لمعرفة ما إن كانت السنوات 2018, 2019 و 2020 هي سنوات كبيسة أم لا, و من ثم عرضنا ما سترجعه في كل مرة calendar من الكلاس isleap() هنا قمنا باستدعاء الدالة
                    print(calendar.isleap(2018))
                    print(calendar.isleap(2019))
                    print(calendar.isleap(2020))
                  

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

False
False
True

Python الدالة leapdays()

تعريفها

ترجع عدد السنوات الكبيسة الموجودة من سنة إلى سنة محددة.

بناؤها

                  calendar.leapdays(y1, y2)
                

باراميترات

• مكان الباراميتر y1 نمرر رقم السنة التي نريد أن نبدأ من عندها.

• مكان الباراميتر y2 نمرر رقم السنة التي نريد أن نتوقف قبلها.

قيمة الإرجاع

ترجع عدد السنوات الكبيسة الموجودة من سنة إلى سنة محددة.

مثال

Test.py

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

                    # لمعرفة عدد السنوات الكبيسة الموجودة من عام 2000 إلى ما قبل العام 2018. و من ثم عرضنا العدد الذي سترجعه leapdays() هنا قمنا باستدعاء الدالة
                    print(calendar.leapdays(2000, 2018))
                  

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

5

Python الدالة setfirstweekday()

تعريفها

إفتراضياً, عند عرض التقويم فإنه يظهر يوم الإثنين ( Monday ) كأول يوم في الأسبوع.
هذه الدالة تستخدم لتحديد أول يوم سيبدأ به كل أسبوع.

بناؤها

                  calendar.setfirstweekday(weekday)
                

باراميترات

مكان الباراميتر weekday نمرر إحدى ثوابت الكلاس calendar التي تشير إلى إسم اليوم أو Index الثابت:

• calendar.MONDAY أو 0 لتعيين الإثنين كأول يوم في الأسبوع.

• calendar.TUESDAY أو 1 لتعيين الثلاثاء كأول يوم في الأسبوع.

• calendar.WEDNESDAY أو 2 لتعيين الأربعاء كأول يوم في الأسبوع.

• calendar.THURSDAY أو 3 لتعيين الخميس كأول يوم في الأسبوع.

• calendar.FRIDAY أو 4 لتعيين الجمعة كأول يوم في الأسبوع.

• calendar.SATURDAY أو 5 لتعيين السبت كأول يوم في الأسبوع.

• calendar.SUNDAY أو 6 لتعيين الأحد كأول يوم في الأسبوع.

قيمة الإرجاع

لا ترجع قيمة.

أخطاء محتملة

ترمي الإستثناء calendar.IllegalWeekdayError في حال قمت بتمرير رقم خارج عن النطاق 0 <= weekday &tl;= 6.

مثال

Test.py

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

                    # لتعيين يوم الأحد كأول يوم في أيام الأسبوع calendar.SUNDAY و تمرير الثابت setfirstweekday() هنا قمنا باستدعاء الدالة
                    calendar.setfirstweekday(calendar.SUNDAY)

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

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

                    2018

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

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

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

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

كورس تعلم بايثون

1- أساسيات اللغة

Python - تهيئة بيئة التطوير
Python - أنواع المتغيرات
Python - العوامل
العوامل التي تستخدم للتعامل مع الـ bits (Bitwise Operators) في بايثون
العوامل التي تستخدم لإعطاء قيم للمتغيرات (Assignment Operators) في بايثون
العوامل المنطقية (Logical Operators) في بايثون
عوامل المقارنه (Comparison Operators) في بايثون
Python - الشروط
Python - الحلقات
Python - الأرقام
Python - النصوص
Lists - Python
Tuples - Python
Sets - Python
Dictionaries - Python
Python - الدوال
Modules - Python
Python - التاريخ و الوقت

2-برمجة الكائنات

Python - الكلاس و الكائن
Python - الوراثة
Overriding - Python
Python - الدوال الثابتة
Python - التجريد
Python - تعدد الأشكال

3-برمجة متقدمة

Python - إدخال البيانات
Iterators - Python
Python - التعابير النمطية
Python - التعامل مع الملفات
Python - مدير الحزم ( PIP )
Python - قواعد البيانات
Python - تعدد المهام

تعديل المقال