الفرق بين المراجعتين لصفحة: «Python/datetime/date/isocalendar»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>date.isocalendar()</code> في بايثون}}</noinclude> يعيد التابع صفًّا يضمّ ثلاثة عناص...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>date.isocalendar()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>date.isocalendar()</code> في بايثون}}</noinclude> | ||
يعيد التابع صفًّا يضمّ ثلاثة عناصر هي <code>(ISO year, ISO week number, ISO weekday)</code>. | يعيد التابع [[Python/tuples|صفًّا]] يضمّ ثلاثة عناصر هي <code>(ISO year, ISO week number, ISO weekday)</code>. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 10: | سطر 10: | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). | يعيد التابع [[Python/tuples|صفًّا]] يضمّ ثلاثة عناصر هي <code>(ISO year, ISO week number, ISO weekday).</code> | ||
== توضيح == | == توضيح == | ||
| سطر 18: | سطر 18: | ||
تكوّن السنة في تقويم ISO من 52 أو 53 أسبوعًا كاملًا، ويبدأ كلّ أسبوع بيوم الاثنين وينتهي بيوم الأحد. يوافق الأسبوع الأول في عام ISO الأسبوع الأول في التقويم الكريكوري الذي يتضمّن أوّل يوم خميس في العام. يأخذ هذا الأسبوع الرقم 1، وتكون سنة ISO في ذلك الخميس هي نفسها السنة الكريكورية. | تكوّن السنة في تقويم ISO من 52 أو 53 أسبوعًا كاملًا، ويبدأ كلّ أسبوع بيوم الاثنين وينتهي بيوم الأحد. يوافق الأسبوع الأول في عام ISO الأسبوع الأول في التقويم الكريكوري الذي يتضمّن أوّل يوم خميس في العام. يأخذ هذا الأسبوع الرقم 1، وتكون سنة ISO في ذلك الخميس هي نفسها السنة الكريكورية. | ||
فمثلًا، يبدأ العام 2004 بيوم الخميس، لذا يبدأ الأسبوع الأول في سنة 2004 في تقويم ISO بيوم الاثنين الذي يوافق 29 كانون الأول 2003 وينتهي بيوم الأحد الذي يوافق 4 كانون الثاني 2004. وهكذا يكون | فمثلًا، يبدأ العام 2004 بيوم الخميس، لذا يبدأ الأسبوع الأول في سنة 2004 في تقويم ISO بيوم الاثنين الذي يوافق 29 كانون الأول 2003 وينتهي بيوم الأحد الذي يوافق 4 كانون الثاني 2004. وهكذا يكون <code>date(2003, 12, 29).isocalendar() == (2004, 1,1)</code> ويكون <code>date(2004, 1, 4).isocalendar() == (2004, 1, 7)</code> . | ||
== أمثلة == | == أمثلة == | ||
| سطر 32: | سطر 32: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* التابع <code>[[Python/datetime/date/ | * التابع <code>[[Python/datetime/date/isoweekday|date.isoweekday()]]</code>: يعيد التابع اليوم في الأسبوع على هيئة [[Python/int|عدد صحيح]]، حيث يأخذ يوم الاثنين الرقم <code>0</code> ويوم الأحد الرقم <code>6</code>. | ||
* التابع <code>[[Python/datetime/date/isoformat|date.isoformat()]]</code>: يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601 هي 'YYYY-MM-DD'. | * التابع <code>[[Python/datetime/date/isoformat|date.isoformat()]]</code>: يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601 هي <code>'YYYY-MM-DD'</code>. | ||
* التابع <code>[[Python/datetime/date/weekday|date.weekday()]]</code>: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم <code>0</code> ويوم الأحد الرقم <code>6</code>. | * التابع <code>[[Python/datetime/date/weekday|date.weekday()]]</code>: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم <code>0</code> ويوم الأحد الرقم <code>6</code>. | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 20:42، 26 يونيو 2018
يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (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 في توثيق بايثون الرسمي.