التابع date.isocalendar()‎ في بايثون

يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday).

البنية العامة

‎date.isocalendar()

القيمة المعادة

يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday).

توضيح

تقويم ISO من التقويمات المنتشرة بكثرة كصيغة بديلة عن التقويم الكريكوري. راجع هذا الموضوع للمزيد من المعلومات.

تكوّن السنة في تقويم ISO من 52 أو 53 أسبوعًا كاملًا، ويبدأ كلّ أسبوع بيوم الاثنين وينتهي بيوم الأحد. يوافق الأسبوع الأول في عام ISO الأسبوع الأول في التقويم الكريكوري الذي يتضمّن أوّل يوم خميس في العام. يأخذ هذا الأسبوع الرقم 1، وتكون سنة ISO في ذلك الخميس هي نفسها السنة الكريكورية.

فمثلًا، يبدأ العام 2004 بيوم الخميس، لذا يبدأ الأسبوع الأول في سنة 2004 في تقويم ISO بيوم الاثنين الذي يوافق 29 كانون الأول 2003 وينتهي بيوم الأحد الذي يوافق 4 كانون الثاني 2004. وهكذا يكون ‎date(2003, 12, 29).isocalendar() == (2004, 1,1)‎ ويكون date(2004, 1, 4).isocalendar() == (2004, 1, 7)‎‎ .

أمثلة

يبين المثال التالي آلية عمل التابع:

‎>>> from datetime import date
>>> d = date(2018, 6, 26)
>>> d.isocalendar()
(2018, 26, 2)

انظر أيضًا

• التابع date.isoweekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 0 ويوم الأحد الرقم 6.
• التابع date.isoformat()‎: يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601 هي 'YYYY-MM-DD'.
• التابع date.weekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 0 ويوم الأحد الرقم 6. 

مصادر

قسم date Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.