الفرق بين المراجعتين ل"Python/calendar"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()</code> في بايثون}}</noinclude> تتيح هذه الوحدة الحصول على تقاويم م...') |
|||
| سطر 3: | سطر 3: | ||
تتيح هذه الوحدة الحصول على تقاويم مشابهة لمخرجات البرنامج cal في أنظمة يونكس، إلى جانب أنّها تقدّم عددًا من التوابع المفيدة والخاصة بالتقاويم. يبدأ الأسبوع في هذه التقاويم بصورة افتراضية بيوم الإثنين، وينتهي بيوم الأحد (هذا هو السائد في أوروبا). | تتيح هذه الوحدة الحصول على تقاويم مشابهة لمخرجات البرنامج cal في أنظمة يونكس، إلى جانب أنّها تقدّم عددًا من التوابع المفيدة والخاصة بالتقاويم. يبدأ الأسبوع في هذه التقاويم بصورة افتراضية بيوم الإثنين، وينتهي بيوم الأحد (هذا هو السائد في أوروبا). | ||
| − | يمكن استخدام الدالة setfirsweekday() لجعل الأسبوع يبدأ بيوم الأحد (6) أو أي يوم آخر. تكون المعاملات التي تحدّد التواريخ أعدادًا صحيحة. تقدّم بايثون وحدتين إضافيتين للتعامل مع الوقت والتاريخ هما datetime و | + | يمكن استخدام الدالة <code>[[Python/calendar/setfirstweekday|setfirsweekday()]]</code> لجعل الأسبوع يبدأ بيوم الأحد (6) أو أي يوم آخر. تكون المعاملات التي تحدّد التواريخ أعدادًا صحيحة. تقدّم بايثون وحدتين إضافيتين للتعامل مع الوقت والتاريخ هما <code>[[Python/datetime|datetime]]</code> و <code>time</code>. |
| − | |||
| − | |||
| − | |||
| − | |||
| + | تستخدم الدوال والأصناف المعرّفة في هذه الوحدة تقويمًا مثاليًا، وهو التقويم الكريكوري الحالي والممتدّ في كلا الاتجاهين (الماضي والمستقبل) وإلى ما لا نهاية. يتطابق هذا التقويم مع "التقويم التنبؤي" والذي يقدّمه Dershowitz و Reingold في كتابهما "Calendrical Calculations" والذي يمثّل التقويم الأساسي والمعتمد في جميع أنظمة الحواسيب. يفسّر الصفر والسنوات ذات الأرقام السالبة كما هو موصوف في معيار ISO 8601، لتكون السنة <code>0</code> هي السنة <code>1</code> قبل الميلاد، و <code>-1</code> هي السنة <code>2</code> قبل الميلاد، وهكذا دواليك. | ||
| + | ==دوال الوحدة <code>calendar</code>== | ||
تقدّم وحدة <code>calendar</code> عددًا من الدوال الخاصّة بالتقاويم النصية البسيطة. | تقدّم وحدة <code>calendar</code> عددًا من الدوال الخاصّة بالتقاويم النصية البسيطة. | ||
| + | ===الدالة <code>[[Python/calendar/setfirstweekday|setfirstweekday()]]</code>=== | ||
| + | تعيّن الدالة اليوم الذي يبدأ به الأسبوع. | ||
| − | === الدالة <code> | + | ===الدالة <code>[[Python/calendar/firstweekday|firstweekday()]]</code>=== |
| − | + | تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | === الدالة <code> | + | ===الدالة <code>[[Python/calendar/isleap|isleap()]]</code>=== |
| + | تخبر الدالة ما إذا كانت السنة المعطاة كبيسة أم لا. | ||
| − | === الدالة <code> | + | ===الدالة <code>[[Python/calendar/leapdays|leapdays()]]</code>=== |
| + | تعيد الدالة عدد السنوات الكبيسة ضمن نطاق السنوات المحدد. | ||
| − | === الدالة <code> | + | ===الدالة <code>[[Python/calendar/weekday|weekday()]]</code>=== |
| + | تعيد الدالة يوم الأسبوع في الشهر المعطى في السنة المعطاة. | ||
| − | === الدالة <code> | + | ===الدالة <code>[[weekheader()]]</code>=== |
| + | تعيد الدالة ترويسة تتضمن أسماء أيام الأسبوع بصيغة مختصرة. | ||
| − | === الدالة <code> | + | ===الدالة <code>[[monthrange()]]</code>=== |
| + | تعيد الدالة أول يوم في الشهر وعدد أيام الشهر المعطى في السنة المعطاة. | ||
| − | === الدالة <code> | + | ===الدالة <code>[[monthcalendar()]]</code>=== |
| + | تعيد الدالة مصفوفة matrix تمثّل تقويم الشهر. | ||
| − | === الدالة <code> | + | ===الدالة <code>[[prmonth()]]</code>=== |
| + | تطبع الدالة تقويم الشهر الذي تعيده الدالة <code>month()</code>. | ||
| − | === الدالة <code> | + | ===الدالة <code>[[Python/calendar/month|month()]]</code>=== |
| + | تعيد الدالة تقويم الشهر على هيئة سلسلة نصية متعددة الأسطر. | ||
| + | ===الدالة <code>[[Python/calendar/prcal|prcal()]]</code>=== | ||
| + | تطبع الدالة تقويم السنة برمّتها والذي تعيده الدالة <code>calendar()</code>. | ||
| − | == | + | ===الدالة <code>[[Python/calendar/calendar|calendar()]]</code>=== |
| + | تعيد الدالة تقويمًا ذا ثلاثة أعمدة يتضمّن سنة كاملة وعلى هيئة سلسلة نصية متعددة الأسطر. | ||
| − | + | ===الدالة <code>[[Python/calendar/timegm|timegm()]]</code>=== | |
| + | تعيد الدالة قيمة الختم الزمني المقابل في نظام يونكس. | ||
| − | === الخاصية <code>calendar.day_name</code> === | + | ==خصائص الوحدة <code>calendar</code>== |
| + | تقدّم وحدة <code>calendar</code> الخصائص التالية: | ||
| + | ===الخاصية <code>calendar.day_name</code>=== | ||
مصفوفة تعرض أيام الأسبوع في الإعدادات المحلية الحالية. | مصفوفة تعرض أيام الأسبوع في الإعدادات المحلية الحالية. | ||
| − | + | ===الخاصية <code>calendar.day_abbr</code>=== | |
| − | === الخاصية <code>calendar.day_abbr</code> === | ||
| − | |||
مصفوفة تعرض الأسماء المختصرة لأيام الأسبوع في الإعدادات المحلية الحالية. | مصفوفة تعرض الأسماء المختصرة لأيام الأسبوع في الإعدادات المحلية الحالية. | ||
| − | + | ===الخاصية <code>calendar.month_name</code>=== | |
| − | === الخاصية <code>calendar.month_name</code> === | ||
| − | |||
مصفوفة تعرض أشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم 1، لذا يكون طول المصفوفة 13، وتكون month_name[0] سلسلة فارغة. | مصفوفة تعرض أشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم 1، لذا يكون طول المصفوفة 13، وتكون month_name[0] سلسلة فارغة. | ||
| − | + | ===الخاصية <code>calendar.month_abbr</code>=== | |
| − | === الخاصية <code>calendar.month_abbr</code> === | + | مصفوفة تعرض الأسماء المختصرة لأشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم <code>1</code>، لذا يكون طول المصفوفة <code>13</code>، وتكون <code>month_name[0]</code> سلسلة فارغة. |
| − | + | ==أصناف الوحدة <code>calendar</code>== | |
| − | مصفوفة تعرض الأسماء المختصرة لأشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم | ||
| − | |||
| − | == أصناف الوحدة <code>calendar</code> == | ||
| − | |||
تقدم وحدة <code>calendar</code> الأصناف الخمسة التالية للتعامل مع التقاويم بطرق مختلفة: | تقدم وحدة <code>calendar</code> الأصناف الخمسة التالية للتعامل مع التقاويم بطرق مختلفة: | ||
| − | + | ===الصنف <code>Calendar</code>=== | |
| − | === الصنف <code>Calendar</code> === | ||
| − | |||
يقدّم كائن Calendar عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق. | يقدّم كائن Calendar عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق. | ||
| − | + | ===الصنف <code>TextCalendar</code>=== | |
| − | === الصنف <code>TextCalendar</code> === | ||
| − | |||
يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text. | يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text. | ||
| − | + | ===الصنف <code>HTMLCalendar</code>=== | |
| − | === الصنف <code>HTMLCalendar</code> === | ||
| − | |||
يمكن استخدام هذا الصنف لإنشاء تقاويم بصيغة HTML. | يمكن استخدام هذا الصنف لإنشاء تقاويم بصيغة HTML. | ||
| − | + | ===الصنف <code>LocaleTextCalendar</code>=== | |
| − | === الصنف <code>LocaleTextCalendar</code> === | ||
| − | |||
هذا الصنف متفرّع من الصنف TextCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة. | هذا الصنف متفرّع من الصنف TextCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة. | ||
| − | + | ===الصنف <code>LocaleHTMLCalendar</code>=== | |
| − | === الصنف <code>LocaleHTMLCalendar</code> === | ||
| − | |||
هذا الصنف متفرّع من الصنف HTMLCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة HTML. | هذا الصنف متفرّع من الصنف HTMLCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة HTML. | ||
| − | + | ==انظر أيضًا== | |
| − | == انظر أيضًا == | + | *[[Python/datetime|وحدة <code>datetime</code> في بايثون.]] |
| − | + | ==مصادر== | |
| − | * وحدة datetime في بايثون. | + | *[https://docs.python.org/3/library/calendar.html#module-calendar صفحة General calendar-related functions في توثيق بايثون الرسمي.] |
| − | |||
| − | == مصادر == | ||
| − | * [https://docs.python.org/3/library/calendar.html#module-calendar صفحة General calendar-related functions في توثيق بايثون الرسمي.] | ||
| − | |||
| − | |||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
مراجعة 18:51، 3 أغسطس 2018
تتيح هذه الوحدة الحصول على تقاويم مشابهة لمخرجات البرنامج cal في أنظمة يونكس، إلى جانب أنّها تقدّم عددًا من التوابع المفيدة والخاصة بالتقاويم. يبدأ الأسبوع في هذه التقاويم بصورة افتراضية بيوم الإثنين، وينتهي بيوم الأحد (هذا هو السائد في أوروبا).
يمكن استخدام الدالة setfirsweekday() لجعل الأسبوع يبدأ بيوم الأحد (6) أو أي يوم آخر. تكون المعاملات التي تحدّد التواريخ أعدادًا صحيحة. تقدّم بايثون وحدتين إضافيتين للتعامل مع الوقت والتاريخ هما datetime و time.
تستخدم الدوال والأصناف المعرّفة في هذه الوحدة تقويمًا مثاليًا، وهو التقويم الكريكوري الحالي والممتدّ في كلا الاتجاهين (الماضي والمستقبل) وإلى ما لا نهاية. يتطابق هذا التقويم مع "التقويم التنبؤي" والذي يقدّمه Dershowitz و Reingold في كتابهما "Calendrical Calculations" والذي يمثّل التقويم الأساسي والمعتمد في جميع أنظمة الحواسيب. يفسّر الصفر والسنوات ذات الأرقام السالبة كما هو موصوف في معيار ISO 8601، لتكون السنة 0 هي السنة 1 قبل الميلاد، و -1 هي السنة 2 قبل الميلاد، وهكذا دواليك.
دوال الوحدة calendar
تقدّم وحدة calendar عددًا من الدوال الخاصّة بالتقاويم النصية البسيطة.
الدالة setfirstweekday()
تعيّن الدالة اليوم الذي يبدأ به الأسبوع.
الدالة firstweekday()
تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع.
الدالة isleap()
تخبر الدالة ما إذا كانت السنة المعطاة كبيسة أم لا.
الدالة leapdays()
تعيد الدالة عدد السنوات الكبيسة ضمن نطاق السنوات المحدد.
الدالة weekday()
تعيد الدالة يوم الأسبوع في الشهر المعطى في السنة المعطاة.
الدالة weekheader()
تعيد الدالة ترويسة تتضمن أسماء أيام الأسبوع بصيغة مختصرة.
الدالة monthrange()
تعيد الدالة أول يوم في الشهر وعدد أيام الشهر المعطى في السنة المعطاة.
الدالة monthcalendar()
تعيد الدالة مصفوفة matrix تمثّل تقويم الشهر.
الدالة prmonth()
تطبع الدالة تقويم الشهر الذي تعيده الدالة month().
الدالة month()
تعيد الدالة تقويم الشهر على هيئة سلسلة نصية متعددة الأسطر.
الدالة prcal()
تطبع الدالة تقويم السنة برمّتها والذي تعيده الدالة calendar().
الدالة calendar()
تعيد الدالة تقويمًا ذا ثلاثة أعمدة يتضمّن سنة كاملة وعلى هيئة سلسلة نصية متعددة الأسطر.
الدالة timegm()
تعيد الدالة قيمة الختم الزمني المقابل في نظام يونكس.
خصائص الوحدة calendar
تقدّم وحدة calendar الخصائص التالية:
الخاصية calendar.day_name
مصفوفة تعرض أيام الأسبوع في الإعدادات المحلية الحالية.
الخاصية calendar.day_abbr
مصفوفة تعرض الأسماء المختصرة لأيام الأسبوع في الإعدادات المحلية الحالية.
الخاصية calendar.month_name
مصفوفة تعرض أشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم 1، لذا يكون طول المصفوفة 13، وتكون month_name[0] سلسلة فارغة.
الخاصية calendar.month_abbr
مصفوفة تعرض الأسماء المختصرة لأشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم 1، لذا يكون طول المصفوفة 13، وتكون month_name[0] سلسلة فارغة.
أصناف الوحدة calendar
تقدم وحدة calendar الأصناف الخمسة التالية للتعامل مع التقاويم بطرق مختلفة:
الصنف Calendar
يقدّم كائن Calendar عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق.
الصنف TextCalendar
يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text.
الصنف HTMLCalendar
يمكن استخدام هذا الصنف لإنشاء تقاويم بصيغة HTML.
الصنف LocaleTextCalendar
هذا الصنف متفرّع من الصنف TextCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة.
الصنف LocaleHTMLCalendar
هذا الصنف متفرّع من الصنف HTMLCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة HTML.