بايثون التعامل مع التاريخ و الوقت
مقدمة
بايثون تحتوي على أكثر من موديول جاهز للتعامل مع التاريخ, الوقت و التقويم بكل سهولة.
في هذا الدرس ستتعلم طريقة الإستفادة من الموديول datetime
و الموديول calendar
لعرض التاريخ, الوقت و التقويم بالشكل الذي تحتاجه.
الموديول datetime
الموديول datetime
يحتوي على مجموعة كلاسات فيها دوال جاهزة للتعامل مع التاريخ و الوقت.
date
: يحتوي على مجموعة دوال خاصة للتعامل مع التاريخ.time
: يحتوي على مجموعة دوال خاصة للتعامل مع الوقت.datetime
: يحتوي على مجموعة دوال خاصة للتعامل مع التاريخ و الوقت.timedelta
: يحتوي على مجموعة دوال خاصة لحساب الفرق بدقة بين تاريخ و آخر.timezone
: يحتوي على مجموعة دوال خاصة لحساب فرق التوقيت بين تاريخ و آخر على حسب المنطقة الزمنية لكل تاريخ.
في المثال التالي قمنا بتخزين التاريخ و الوقت الحالي بالإعتماد على الدالة now()
الموجودة في الكلاس datetime
الموجود بداخل الموديول datetime
.
المثال الأول
# datetime هنا قمنا بتضمين كل محتوى الموديول import datetime # dt في الكائن datetime ككائن من الكلاس now() هنا قمنا بتخزين التاريخ و الوقت الحالي الذي سترجعه الدالة dt = datetime.datetime.now() # dt هنا قمنا بعرض قيمة الكائن print(dt)
سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.
نلاحظ من المثال السابق أن الكلاس 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
مع تحديد التاريخ الذي نريد تخزينه فيه مباشرةً عند إنشاءه.
المثال الأول
# datetime هنا قمنا بتضمين كل محتوى الموديول import datetime # dt يمثل تاريخ محدد و قمنا بتخزينه في الكائن datetime هنا قمنا بإنشاء كائن من الكلاس dt = datetime.datetime(2012, 4, 5) # dt هنا قمنا بعرض قيمة الكائن print(dt)
سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.
في المثال التالي قمنا بإنشاء كائن من الكلاس datetime
مع تحديد التاريخ و الوقت الذي نريد تخزينه فيه مباشرةً عند إنشاءه.
المثال الثاني
# datetime هنا قمنا بتضمين كل محتوى الموديول import datetime # dt يمثل تاريخ + وقت محدد و قمنا بتخزينه في الكائن datetime هنا قمنا بإنشاء كائن من الكلاس dt = datetime.datetime(2012, 4, 5, 7, 30, 46) # dt هنا قمنا بعرض قيمة الكائن print(dt)
سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.
خصائص الكلاس datetime
الجدول التالي يحتوي على خصائص الكلاس datetime
الموجود في الموديول datetime
.
إسم الثابت | تعريفه |
---|---|
year |
يحتوي على رقم السنة المخزن في كائن الـdatetime . |
month |
يحتوي على رقم الشهر المخزن في كائن الـdatetime . |
day |
يحتوي على رقم اليوم المخزن في كائن الـdatetime . |
hour |
يحتوي على رقم الساعة المخزن في كائن الـdatetime . |
minute |
يحتوي على رقم الدقائق المخزن في كائن الـdatetime . |
second |
يحتوي على رقم الثواني المخزن في كائن الـdatetime . |
microsecond |
يحتوي على رقم أجزاء الثواني المخزن في كائن الـdatetime . |
في المثال التالي قمنا بعرض السنة فقط من التاريخ المخزن في كائن الـ datetime
بالإعتماد على الخاصية year
.
مثال
# datetime هنا قمنا بتضمين كل محتوى الموديول import datetime # dt في الكائن datetime ككائن من الكلاس now() هنا قمنا بتخزين التاريخ و الوقت الحالي الذي سترجعه الدالة dt = datetime.datetime.now() # dt الموجودة في الكائن year هنا قمنا بعرض قيمة الخاصية print('This tutorial is written in', dt.year)
سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.
تحديد فورمات التاريخ و الوقت
في البداية, المقصود بتحديد فورمات ( Format ) التاريخ و الوقت هو عرضه أو تخزينه أو بشكل مختلف.
لتحديد فورمات التاريخ و الوقت الذي نريد إظهاره نستخدم دالة جاهزة في الكلاس datetime
إسمها strftime()
.
إستخدام هذه الدالة سهل جداً, حيث نستدعيها من كائن الـ datetime
و من ثم نمرر لها رمز أو مجموعة رموز منفصلة لتحديد الأشياء التي نريدها أن ترجعهم لنا كنص.
في المثال التالي قمنا بالإعتماد على الدالة strftime()
الموجودة في الكلاس datetime
لعرض إسم الشهر الحالي.
مثال
# datetime هنا قمنا بتضمين كل محتوى الموديول import datetime # dt في الكائن datetime ككائن من الكلاس now() هنا قمنا بتخزين التاريخ و الوقت الحالي الذي سترجعه الدالة dt = datetime.datetime.now() # و من ثم قمنا بطباعته dt لها كنص حتى ترجع إسم الشهر المخزن في الكائن %B و تمرير الرمز strftime() هنا قمنا باستدعاء الدالة print(dt.strftime('%B'))
سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.
الرموز التي يمكن إستخدامها في الدالة 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
.
المثال الأول
# 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 الثابت:
|