نتائج البحث

يتيح هذا التابع إعادة تمثيل للكائن time على هيئة سلسلة نصية قابلة للطباعة، باستخدام الدالة str()‎. البنية العامة ‎time.__str__() القيمة المعادة يعيد التابع تمثيلًا للكائن time على هيئة سلسلة نصية قابلة للطباعة، ولو فرضنا أنّ t هو كائن وقت، فإنّ str(t)‎ مكافئة للتابع t.isoformat()‎. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import time >>> t = time(19, 22, 48) >>> t.__str__() '19:22:48' >>> str(t) '19:22:48' >>> t.isoformat() '19:22:48' انظر أيضًا التابع time.isoformat()‎: يعيد التابع سلسلة نصية تمثّل الوقت بصيغة ISO 8601. التابعان strftime()‎ و ...

يسمح هذا التابع بتعيين سلسلسة تنسيق نصية لكائن الوقت باستخدام محارف سلاسل التنسيق النصية وعند استخدام التابع str.format()‎. البنية العامة ‎time.__format__(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية ذات تنسيق محدّد بواسطة موجّهات التنسيق الخاصة. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import time >>> t = time(17, 39, 14) >>> 'The {} is {:%H:%M}.'.format("time", t) 'The time is 17:39.' انظر أيضًا ...

يمثل كائن التاريخ date تاريخًا (سنة وشهر ويوم) في التقويم المثالي، وهو التقويم الميلادي الممتدّ إلى ما لا نهاية في كلا الاتجاهين، ويمثّل اليوم ذو التاريخ 1 كانون الثاني (يناير) سنة 1 ميلادي اليوم ذا العدد 1 في هذا الكائن، واليوم ذو التاريخ 2 كانون الثاني (يناير) سنة 1 ميلادي اليوم ذا العدد 2 في هذا الكائن، وهكذا دواليك. يطابق هذا الترقيم تعريف "التقويم الكريكوري التنبؤي proleptic Gregorian" والذي وضعه كلّ من Dershowitz و Reingold في كتابهما Calendrical Calculations والذي ...

يتيح هذا التابع إعادة تمثيل للكائن date على هيئة سلسلة نصية قابلة للطباعة، باستخدام الدالة str()‎. البنية العامة ‎date.__str__() القيمة المعادة يعيد التابع تمثيلًا للكائن date على هيئة سلسلة نصية قابلة للطباعة، ولو فرضنا أنّ d هو كائن تاريخ، فإنّ str(d)‎ مكافئة للتابع d.isoformat()‎. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 27) >>> d.__str__() '2018-06-27' >>> str(d) '2018-06-27' >>> d.isoformat() '2018-06-27' انظر أيضًا التابع date.isoformat()‎: يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601 هي 'YYYY-MM-DD'. التابعان ...

يسمح هذا التابع بتعيين سلسلسة تنسيق نصية لكائن التاريخ باستخدام محارف سلاسل التنسيق النصية وعند استخدام التابع str.format()‎. البنية العامة ‎date.__format__(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية ذات تنسيق محدّد بواسطة موجّهات التنسيق الخاصة. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 27) >>> 'The {1} is {0:%d}, the {2} is {0:%B}.'.format(d, "day", "month") 'The ...

يتيح هذا التابع إعادة تمثيل للكائن datetime على هيئة سلسلة نصية قابلة للطباعة، باستخدام الدالة str()‎. البنية العامة ‎datetime.__str__() القيمة المعادة يعيد التابع تمثيلًا للكائن datetime على هيئة سلسلة نصية قابلة للطباعة، ولو فرضنا أنّ dt هو كائن تاريخ، فإنّ str(dt)‎ مكافئة للتابع dt.isoformat()‎. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> dt = datetime(2018, 6, 27, 21, 1) >>> dt.__str__() '2018-06-27 21:01:00' >>> str(dt) '2018-06-27 21:01:00' >>> dt.isoformat() '2018-06-27T21:01:00' انظر أيضًا التابع datetime.isoformat()‎: يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO ...

عناصر <input> ذات النوع time تُنشِئ حقل إدخال يسمح بإدخال الوقت بسهولة. شكل هذا الحقل يختلف من متصفح إلى متصفح، فالدعم الحالي ليس مثاليًا، فالوضع الحالي لهذا الحقل في متصفحات Chrome و Opera و Edge ومتصفحات الهواتف المحمولة لا بأس به، وسيُعرَض كحقل نصي في المتصفحات التي لا تدعمه: <input type="time" name="time"> سيبدو هذا الحقل كما في الصورة الآتية في متصفحَي Chrome و Opera، إذ يظهر سهم علوي وسفلي إضافةً إلى زر لحذف قيمة الحقل، وسيُدخَل الوقت بصيغة 12 ساعة، أي ...

عناصر <input> ذات النوع date تُنشِئ حقل إدخال يسمح بانتقاء التاريخ بسهولة، والتاريخ يتضمن السنة والشهر واليوم لكن ليس الوقت time. شكل هذا الحقل يختلف من متصفح إلى متصفح، فالدعم الحالي ليس مثاليًا (راجع قسم دعم المتصفحات لمزيدٍ من المعلومات)، لكن هذا الحقل سيُعرَض كحقل نصي في المتصفحات التي لا تدعمه: <input type="date" name="date"> سيبدو هذا الحقل كما في الصورة الآتية في متصفحَي Chrome و Opera: لقطة لكيفية عرض الحقل date في متصفحَي Chrome و Opera. أما في متصفح Edge فسيبدو ...

الدالة البانية Date تُنشِئ كائنًا من النوع Date الذي يُمثِّل لحظة زمنية معيّنة. القيمة الزمنية الموجودة في كائنات Date هي كم ملي ثانية مضى منذ تاريخ 1 كانون الثاني (يناير) 1970 بتوقيت UTC. البنية العامة new Date(); new Date(value); new Date(dateString); new Date(year, month, day, hours, minutes, seconds, milliseconds); ملاحظة: كائنات Date في JavaScript يمكن تهيئتها باستخدام Date كدالة بانية فقط، أي استدعاؤها كدالة عادية (دون المعامل new) وسيُعيد ذلك سلسلةً نصيةً بدلًا من الكائن Date، وعلى النقيض من بقية أنواع كائنات JavaScript، لا ...

يعيد التابع كائن datetime الناتج عن دمج كائني date و time بعضهما ببعض. البنية العامة ‎classmethod datetime.combine(date, time, tzinfo=self.tzinfo) المعاملات date كائن date المراد استخدامه لإنشاء الكائن الجديد. time كائن time المراد استخدامه لإنشاء الكائن الجديد. tzinfo معامل اختياري تُحدّد بواسطته المنطقة الزمنية المطلوبة. تستخدم قيمة المعامل tzinfo في حال توفّرها كقيمة لخاصية tzinfo في الكائن الجديد، أما في حال عدم توفّرها فتُستخدم خاصية tzinfo التابعة لمعامل time. القيمة المعادة يعيد التابع كائن datetime تكون مكوّنات التاريخ فيه مساوية لكائنات ...

يعيد التابع كائن date يتضمّن نفس السنة والشهر واليوم في كائن datetime. البنية العامة ‎datetime.date() القيمة المعادة يعيد التابع كائن date يتضمّن نفس السنة والشهر واليوم في كائن datetime. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> dt = datetime(2018, 6, 7, 22, 45, 6) >>> dt.date() datetime.date(2018, 6, 7) انظر أيضًا التابع datetime.time()‎‎: يعيد كائن time يتضمّن نفس الساعة والدقيقة والثانية وأجزاء الثانية وfold في كائن datetime. التابع datetime.timetz()‎‎: يعيد كائن time يتضمّن نفس الساعة والدقيقة والثانية ...

ينسّق التابع الوقت باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة ‎time.strftime(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية تمثّل الوقت، ويمكن التحكّم بطريقة التمثيل هذه باستخدام سلسلة تنسيق نصية. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import time >>> t = time(12, 10, 30) >>> t.strftime("%H:%M:%S") '12:10:30' انظر أيضًا التابعان strftime()‎ و strptime()‎ . التابع time.__format__()‎: يسمح هذا التابع بتعيين سلسلسة تنسيق ...

يعيد التابع كائن time يتضمّن نفس الساعة والدقيقة والثانية وأجزاء الثانية وfold في كائن datetime. البنية العامة ‎‎datetime.time() القيمة المعادة يعيد التابع كائن time يتضمّن نفس الساعة والدقيقة والثانية وأجزاء الثانية وحالة التوقيت المحلي (fold) في كائن datetime. يُعيد التابِع أيضًا المُعامِل tzinfo بالقيمة None. أمثلة يُبيّن المثال التالي آلية عمل التابع: ‎‎‎>>> from datetime import datetime >>> dt = datetime(2018, 6, 7, 22, 45, 6) >>> dt.time() datetime.time(22, 45, 6) >>> type(dt.time().tzinfo) <class 'NoneType'> انظر أيضًا التابع datetime.date()‎‎: يعيد التابع كائن date يتضمّن نفس ...

يعيد التابع كائن time يتضمّن نفس الساعة والدقيقة والثانية وأجزاء الثانية وfold وtzinfo في كائن datetime. البنية العامة datetime.timetz() القيمة المعادة يعيد التابع كائن time يتضمّن نفس الساعة والدقيقة والثانية وأجزاء الثانية وحالة التوقيت المحلي (fold) ومعلومات المنطقة الزمنيّة (tzinfo) في كائن datetime. أمثلة يُبيّن المثال التالي آلية عمل التابع: >>> from datetime import datetime >>> dt = datetime(2018, 6, 7, 22, 45, 6, 1, None) >>> dt.timetz() datetime.time(22, 45, 6, 1) >>> type(dt.timetz().tztinfo) <class 'NoneType'> انظر أيضًا التابع datetime.date()‎‎:يعيد التابع كائن date يتضمّن نفس ...

يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع date.isoformat()‎. البنية العامة ‎date.fromisoformat(date_string) المعاملات date_string سلسلة نصية تتضمّن التاريخ المطلوب تحويله إلى كائن date، وتتبع السلسلة النصية الصيغة YYYY-MM-DD. القيمة المعادة كائن date يكون التاريخ فيه موافقًا للتاريخ المعطى في السلسلة النصية date_string. تنبيه: لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع date.isoformat()‎. ملاحظة: هذا التابع جديد في الإصدار 3.7 من اللغة. أمثلة يبين المثال التالي ...

يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح. البنية العامة ‎date.weekday() القيمة المعادة يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 0 ويوم الأحد الرقم 6. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 26) >>> d.weekday() 1 انظر أيضًا التابع date.isoweekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 1 ويوم الأحد الرقم 7. مصادر قسم date Objects في صفحة ...

الصنف Time هو تجريد لمفهومي التاريخ والوقت. يتم تخزين Time داخليا كعدد الثواني (مع كسورها) منذ توقيت يونيكس (1 يناير 1970 00:00 بالتوقيت العالمي). انظر أيضًا الوحدة Date لمزيد من المعلومات. يعامِل الصنف Time توقيت جرينتش (GMT، اختصار للعبارة Greenwich Mean Time) والتوقيت العالمي الموحد (UTC، اختصار للعبارة Universal Time Coordinated) على أنهما متكافئان. توقيت جرينتش هو الطريقة الأقدم للإشارة إلى هذه الأوقات المرجعية، ولا تزال موجودة في أسماء الاستدعاءات على أنظمة POSIX. يمكن أن يكون لجميع الأوقات كسور. انتبه لهذا ...

يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601. البنية العامة ‎date.isoformat() القيمة المعادة يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601 وهي 'YYYY-MM-DD'. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 27) >>> d.isoformat() '2018-06-27' انظر أيضًا التابع date.isocalendar()‎: يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). التابع date.isoweekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 0 ويوم الأحد ...

يعيد التابع العدد الترتيبي للتاريخ الذي يمثّله كائن التاريخ حسب التقويم التنبّؤي الكريكوري. البنية العامة ‎date.toordinal() القيمة المعادة يعيد التابع العدد الترتيبي للتاريخ الذي يمثّله كائن التاريخ حسب التقويم التنبّؤي الكريكوري، حيث يحمل تاريخ الأول من كانون الثاني سنة 1 ميلادية العدد 1. ولو فرضنا أن d هو كائن تاريخ، فإنّ ‎‎date.fromordinal(d.toordinal()) == d‎ أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 26) >>> d.toordinal() 736871 انظر أيضًا التابع date.fromordinal()‎: يعيد التابع التاريخ الموافق ...

ينسّق التابع التاريخ باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة ‎date.strftime(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية تمثّل الوقت، ويمكن التحكّم بطريقة التمثيل هذه باستخدام سلسلة تنسيق نصية. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 27) >>> d.strftime("%d/%m/%y") '27/06/18' >>> d.strftime("%A %d. %B %Y") 'Wednesday 27. June 2018' انظر أيضًا التابعان strftime()‎ و strptime()‎ . التابع ...

يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية. البنية العامة ‎date.today() القيمة المعادة يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية. أمثلة يبين المثال التالي القيمة المعادة من استخدام التابع: >>> from datetime import date >>> today = date.today() >>> print(today) 2018-06-25 انظر أيضًا التابع date.fromtimestamp()‎ : يعيد هذا التابع التاريخ المحلي المرتبط بالختم الزمني ذي الصيغة POSIX. التابع date.fromordinal()‎: يعيد هذا التابع التاريخ بحسب العدد الترتيبي المعطى والتابع للتقويم الكريكوري التنبؤي. مصادر قسم date Objects في صفحة Basic date and time types في توثيق ...

يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغة POSIX كالذي يعيده التابع time.time()‎. البنية العامة date.fromtimestamp(timestamp) المعاملات timestamp الختم الزمني بصيغة POSIX والمراد معرفة التاريخ المحلي الموافق له. يعيد التابع time.time()‎ ختمًا زمنيًا بصيغة POSIX. القيمة المعادة إن كان الختم الزمني خارج نطاق القيم التي تدعمها الدالة localtime()‎ في منصّة C، فإنّ التابع يطلق الخطأ OverflowError، وإن حدث خطأ في تنفيذ الدالة localtime()‎ فإنّ التابع يطلق الخطأ OSError. من الشائع أن يكون استخدام هذا التابع مقصورًا على السنوات 1970 ...

يعيد التابع سلسلة نصية تمثل التاريخ، وتتضمّن الاسم المختصر لكل من اليوم والشهر يتبعهما اليوم ثم الساعة والدقيقة والثانية ثم السنة. البنية العامة ‎date.ctime() القيمة المعادة يعيد التابع سلسلة نصية تمثل التاريخ. التعبير d.ctime()‎ مكافئ للتعبير time.ctime(time.mktime(d.timetuple()))‎ في المنصّات التي تكون فيها دالة ctime()‎ بلغة C (والتي يستدعيها التابع time.ctime()‎ ولا يستدعيها التابع date.ctime()‎) متوافقة مع معايير لغة C. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 27) >>> d.ctime() 'Wed Jun 27 00:00:00 ...

يسمح هذا التابع بتعيين سلسلسة تنسيق نصية لكائن datetime باستخدام محارف سلاسل التنسيق النصية وعند استخدام التابع str.format()‎. البنية العامة ‎datetime.__format__(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية ذات تنسيق محدّد بواسطة موجّهات التنسيق الخاصة. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> d = datetime(2018, 6, 27, 23, 16, 39) >>> dt = datetime(2018, 6, 27, 23, 16, ...

يستبدل التابع القيم المعطاة في المعاملات بالقيم الأصلية في كائن التاريخ. البنية العامة date.replace(year=self.year, month=self.month, day=self.day)‎ المعاملات يأخذ التابع ثلاث معاملات مفتاحية هي year و month و day (السنة والشهر واليوم). تحلّ القيمة المحدّدة لأيّ من هذه المعاملات محلّ القيمة المقابلة في كائن التاريخ. تأخذ هذه المعاملات قيمًا افتراضية تساوي القيم المحدّدة في كائن التاريخ. القيمة المعادة يعيد التابع كائن التاريخ بعد إجراء عملية الاستبدال المحدّدة بواسطة المعاملات. أمثلة يبين المثال التالية آلية عمل التابع: >>> from datetime import date >>> ...

يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، بالاعتماد على تقويم ISO. البنية العامة ‎date.isoweekday() القيمة المعادة يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 1 ويوم الأحد الرقم 7، وذلك بالاعتماد على تقويم ISO. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 26) >>> d.isoweekday() 2 انظر أيضًا التابع date.isocalendar()‎: يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). التابع date.isoformat()‎: ...

ينسّق التابع كائن datetime الموافق لسلسلة التاريخ النصية المعطاة، باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة datetime.strptime(date_string, format) المعاملات date_string سلسلة التاريخ النصية التي يستخدمها التابع لإنشاء كائن datetime الموافق. format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق الوقت والتاريخ في كائن datetime المعاد. راجع قسم (التابعان strftime()‎ و strptime()‎ ). تطلق اللغة الخطأ ValueError إن لم يكن التابع time.strptime()‎ قادرًا على تفسير سلسلة التاريخ النصية أو سلسلة التنسيق النصية، أو إن أعاد التابع قيمة ليست من نوع صفّ وقتي ...

يحدّد التابع اسم المنطقة الزمنية لكائن الوقت. البنية العامة ‎time.tzname() القيمة المعادة إن أخذ الكائن tzinfo القيمة None، فإنّ التابع يعيد القيمة ذاتها، وإلاّ فإنّه يعيد self.tzinfo.tzname(None)‎، ويطلق التابع استثناءً إن لم تُعِد العبارة السابقة القيمة None أو كائن timedelta بفارق زمني لا يتجاوز اليوم الواحد. ملاحظة: في الإصدار 3.7 من بايثون، لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقيّدًا بعدد صحيح من الدقائق. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import time, tzinfo, timedelta >>> class ...

يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح. البنية العامة ‎datetime.weekday() القيمة المعادة يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 0 ويوم الأحد الرقم 6. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> d = date(2018, 6, 26, 20, 47) >>> d.weekday() 1 انظر أيضًا التابع datetime.isoweekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 1 ويوم الأحد الرقم 7. مصادر قسم datetime Objects ...

يعيد التابع الصنف time.struct_time كما تعيده الدالة time.localtime()‎. تكون الساعات والدقائق والثواني أصفارًا، وتأخذ الراية DST القيمة ‎-1. هذا التابع مكافئ للصنف ‎time.struct_time((d.year, d.month,d.day, 0, 0, 0, d.weekday(), yday, -1))‎ حيث ‎yday = d.toordinal() - date(d.year,1, 1).toordinal() + 1‎ وهو عدد اليوم في السنة الحالية بدءًا من اليوم الأول فيها. البنية العامة date.timetuple() القيمة المعادة يعيد التابع الصنف time.struct_time. وهو عبارة عن كائن يتضمّن صفًّا مسمّىً named tuple. ويمكن الوصول إلى القيم عبر الفهرس index أو عبر اسم الخاصية، وكما ...

يتيح التابع القدرة على تحديد ما إذا كان التوقيت الصيفي مستخدمًا أم لا. البنية العامة ‎time.dst() القيمة المعادة إن أخذ الكائن tzinfo القيمة None، فإنّ التابع يعيد القيمة ذاتها، وإلاّ فإنّه يعيد self.tzinfo.dst(None)‎‎، ويطلق التابع استثناءً إن لم تُعِد العبارة السابقة القيمة None أو كائن timedelta بفارق زمني لا يتجاوز اليوم الواحد. ملاحظة: في الإصدار 3.7 من بايثون، لم يعد مقدار الإزاحة عن نظام التوقيت الصيفي مقيّدًا بعدد صحيح من الدقائق. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from ...

يستبدل التابع القيم المعطاة في المعاملات بالقيم الأصلية في كائن الوقت. البنية العامة ‎time.replace(hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, * fold=0) المعاملات يأخذ التابع خمسة معاملات مفتاحية، هي hour و minute و second و microsecond (الساعة والدقيقة والثانية وجزء الثانية). تحلّ القيمة المحدّدة لأيّ من هذه المعاملات محلّ القيمة المقابلة في كائن الوقت. يمكن تعيين قيمة None للمعامل tzinfo لإنشاء كائن وقت بسيط باستخدام كائن وقت واعي، دون الحاجة إلى تحويل بيانات الوقت. ملاحظة: أضيف المعامل fold في الإصدار 3.6 من ...

يحدّد التابع مقدار الإزاحة عن التوقيت العالمي المنسّق. البنية العامة ‎time.utcoffset() القيمة المعادة إن أخذ الكائن tzinfo القيمة None، فإنّ التابع يعيد القيمة ذاتها، وإلاّ فإنّه يعيد self.tzinfo.utcoffset(None)‎، ويطلق التابع استثناءً إن لم تُعِد العبارة السابقة القيمة None أو كائن timedelta بفارق زمني لا يتجاوز اليوم الواحد. ملاحظة: في الإصدار 3.7 من بايثون، لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقيّدًا بعدد صحيح من الدقائق. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import time, tzinfo, timedelta >>> ...

يعيد التابع العدد الترتيبي للتاريخ الذي يمثّله كائن datetime حسب التقويم التنبّؤي الكريكوري. البنية العامة ‎datetime.toordinal() القيمة المعادة يعيد التابع العدد الترتيبي للتاريخ الذي يمثّله كائن datetime حسب التقويم التنبّؤي الكريكوري، حيث يحمل تاريخ الأول من كانون الثاني سنة 1 ميلادية العدد 1. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> dt = datetime(2018, 6, 26, 11, 42, 10) >>> dt.toordinal() 736871 انظر أيضًا التابع Python/datetime/datetime/fromordinal‎: يعيد التابع كائن datetime الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في ...

يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). البنية العامة ‎date.isocalendar() القيمة المعادة يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). توضيح تقويم ISO من التقويمات المنتشرة بكثرة كصيغة بديلة عن التقويم الكريكوري. راجع هذا الموضوع للمزيد من المعلومات. تكوّن السنة في تقويم ISO من 52 أو 53 أسبوعًا كاملًا، ويبدأ كلّ أسبوع بيوم الاثنين وينتهي بيوم الأحد. يوافق الأسبوع الأول في عام ISO الأسبوع الأول في التقويم ...

يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. البنية العامة date.fromordinal(ordinal) المعاملات ordinal العدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. القيمة المعادة يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري. ن كانت قيمة المعامل ordinal المعطاة تقع خارج النطاق ‎1 <= ordinal <= date.max.toordinal()‎ فإنّ اللغة تطلق الخطأ ValueError. لو فرضنا ...

يعيد التابع سلسلة نصية تمثل التاريخ والوقت، وتتضمّن الاسم المختصر لكل من اليوم والشهر يتبعهما اليوم ثم الساعة والدقيقة والثانية ثم السنة. البنية العامة ‎datetime.ctime() القيمة المعادة يعيد التابع سلسلة نصية تمثل التاريخ والوقت، مثل: datetime(2002, 12, 4, 20, 30, 40).ctime() == 'Wed Dec 4 20:30:40 2002' التعبير d.ctime()‎ مكافئ للتعبير time.ctime(time.mktime(d.timetuple()))‎ في المنصّات التي تكون فيها دالة ctime()‎ بلغة C (والتي يستدعيها التابع time.ctime()‎ ولا يستدعيها التابع datetime.ctime()‎) متوافقة مع معايير لغة C. أمثلة يبين المثال التالي آلية ...

يعيد التابع القيمة الثابتة لمقدار الإزاحة عن التوقيت العالمي المنسّق والتي جرى تحديدها عند بناء نسخة الصنف timezone. البنية العامة ‎timezone.utcoffset(dt) القيمة المعادة يعيد التابع القيمة الثابتة التي جرى تحديدها عند بناء نسخة الصنف timezone، ويجري تجاهل المعامل dt. تكون القيمة المعادة عبارة عن نسخة من الصنف timedelta مساوية لفارق التوقيت بين التوقيت المحلي والتوقيت العالمي المنسّق. ملاحظة: لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق محصورًا بالأرقام الصحيحة للدقائق في الإصدار 3.7 من اللغة. أمثلة يبين المثال التالي آلية ...

يعيد التابع الصنف time.struct_time كما تعيده الدالة time.localtime()‎. البنية العامة ‎datetime.timetuple() القيمة المعادة يعيد التابع الصنف time.struct_time. وهو عبارة عن كائن يتضمّن صفًّا مسمّىً named tuple. ويمكن الوصول إلى القيم عبر الفهرس index أو عبر اسم الخاصية، وكما هو موضح في الجدول التالي: الفهرس اسم الخاصية الوصف 0 tm_year السنة 1 tm_mon الشهر 2 tm_mday اليوم 3 tm_hour الساعة 4 tm_min الدقيقة 5 tm_sec الثانية 6 tm_wday عدد اليوم في الأسبوع 7 tm_yday عدد اليوم في السنة 8 tm_isdst التوقيت ...

يعيد التابع سلسلة نصية تمثّل الوقت بصيغة المعيار ISO 8601. البنية العامة ‎time.isoformat(timespec='auto') المعاملات timespec يحدّد المعامل الاختياري timespec عدد المكوّنات الإضافية التي سيتضمّنها كائن الوقت (القيمة الافتراضية هي 'auto')، ويمكن للمكونات أن تكون واحدة ممّا يلي: 'auto': مشابه للمكون 'second' إن كانت أجزاء الثانية مساوية للصفر، وإلا فإنّه مشابه للمكوّن 'microseconds'. 'hours': تضمين الساعة بهيئة رقمين HH. 'minutes': تضمين الساعة والدقيقة بالصيغة HH:MM. 'seconds': تضمين الساعة والدقيقة والثانية بالصيغة HH:MM:SS. 'milliseconds': تضمين الوقت كاملًا، مع اقتطاع قيم الثانية الكسرية ...

ينسّق التابع التاريخ والوقت باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة ‎datetime.strftime(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية تمثّل الوقت والتاريخ، ويمكن التحكّم بطريقة التمثيل هذه باستخدام سلسلة تنسيق نصية. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> dt = datetime(2018, 7, 8, 23, 9, 19) >>> dt.strftime("%d/%m/%y") '08/07/18' >>> dt.strftime("%d %b, %Y") '08 Jul, 2018' >>> dt.strftime("%d %b, %Y - %H:%M:%S") '08 ...

يعيد التابع كائن datetime الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. البنية العامة datetime.fromordinal(ordinal) المعاملات ordinal العدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. القيمة المعادة يعيد التابع التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري. ن كانت قيمة المعامل ordinal المعطاة تقع خارج النطاق ‎1 <= ordinal <= date.max.toordinal()‎ فإنّ ...

يعيد التابع التاريخ والوقت الموافقين لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع datetime.isoformat()‎. البنية العامة ‎datetime.fromisoformat(date_string) المعاملات date_string سلسلة نصية تتضمّن التاريخ والوقت المطلوب تحويلهما إلى كائن datetime، وتتبع السلسلة النصية الصيغة: ‎DD[*HH[:MM[:SS[.mmm[mmm]]]][+HH:MM[:SS[.ffffff]]]]‎ ويمكن للرمز * أن يطابق أيّ حرف مفرد. القيمة المعادة كائن datetime يكون التاريخ والوقت فيه موافقين للتاريخ والوقت المعطيين في السلسلة النصية date_string. تنبيه: لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع datetime.isoformat()‎. ملاحظة: ...

يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء tzinfo القيمة None. البنية العامة datetime.utcfromtimestamp(timestamp) المعاملات timestamp سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن datetime. القيمة المعادة يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء tzinfo القيمة None. إن كان الختم الزمني خارج نطاق القيم التي تدعمها الدالة gmtime()‎ في منصّة C، فإنّ التابع يطلق الخطأ OverflowError، وإن حدث خطأ في تنفيذ الدالة gmtime()‎ فإنّ ...

يعيد التابع القيمة الثابتة لاسم المنطقة الزمنية والتي جري تحديدها عند بناء نسخة الصنف timezone. البنية العامة ‎timezone.tzname(dt) المعاملات dt كائن datetime المراد معرفة اسم المنطقة الزمنية الخاصة به. القيمة المعادة يعيد التابع القيمة الثابتة والتي يجري تحديدها عند بناء نسخة الصنف timezone. في حال عدم تحديد قيمة للمعامل name في الدالة البانية لهذا الصنف، فإن الاسم الذي يعيده التابع tzname(dt)‎ يُولّد من قيمة الإزاحة عن التوقيت العالمي المنسّق وبالطريقة التالية: إن كان المعامل offset يحمل القيمة timedelta(0)‎، فإنّ الاسم ...

يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن datetime على هيئة سلسلة نصية. البنية العامة ‎tzinfo.tzname(dt) القيمة المعادة يعيد التابع اسم المنطقة الزمنية الخاصّة بالكائن datetime على هيئة سلسلة نصية. لا يجري تعريف أيّ شيء بخصوص أسماء السلاسل النصية بواسطة الوحدة datetime، وليس من المطلوب أن يحمل الاسم دلالة معيّنة. فعلى سبيل المثال تعدّ السلاسل النصية التالية كلّها صحيحة: "GMT" و "UTC" و "‎-500" و "‎-5:00" و "EDT" و "US/Eastern" و "America/New York". يعيد التابع القيمة None إن كان اسم السلسلة ...

كائن datetime هو كائن مفرد يتضمّن جميع المعلومات المرتبطة بكائني التاريخ date والوقت time. وكما هو الحال مع هذين الكائنين، فإنّ كائن datetime يفترض وجود التقويم الكريكوري والممتد في كلا الاتجاهين، ويفترض كذلك وجود ‎3600*24 ثانية بالضبط في كل يوم. البنية العامة class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0) المعاملات المعاملات الثلاثة الأولى (year, month, day) (السنة والشهر واليوم) تكون مطلوبة عند إنشاء صنف datetime. يمكن للمعامل tzinfo أن يأخذ القيمة None أو نسخة من صنف ...

يعيد التابع عدد الثواني الكلّي في المدّة الزمنية التي يمثّلها كائن timedelta. البنية العامة ‎timedelta.total_seconds()‎ القيمة المعادة يعيد التابع عدد الثواني الكلّي في المدّة الزمنية التي يمثّلها كائن timedelta. يمكن الحصول على نفس نتيجة هذا التابع باستخدام التعبير td / timedelta(seconds=1)‎. ملاحظات 1- عندما تكون المدّة الزمنية التي يمثّلها كائن timedelta كبيرة جدًّا (أكثر من 270 سنة في معظم الأنظمة)، تظهر بعض الأخطاء على مستوى أجزاء من الثانية. 2- هذا التابع جديد في الإصدار 3.2 من اللغة. أمثلة يبين المثال ...

يعيد التابع الوقت والتاريخ حسب التوقيت المحلّي، مع إعطاء المعامل tzinfo القيمة None. البنية العامة datetime.today() القيمة المعادة يعيد التابع الوقت والتاريخ حسب التوقيت المحلّي، مع إعطاء المعامل tzinfo القيمة None. هذا التابع يكافئ في عمله عمل التابع datetime.fromtimestamp(time.time())‎. أمثلة يبين المثال التالي القيمة المعادة من استخدام التابع: >>> from datetime import datetime >>> today = datetime.today() >>> print(today) 2018-07-05 17:45:50.451453 انظر أيضًا التابع datetime.fromtimestamp()‎ : يعيد هذا التابع التاريخ المحلي المرتبط بالختم الزمني ذي الصيغة POSIX. التابع datetime.fromordinal()‎: يعيد هذا التابع التاريخ والوقت بحسب ...

يمثّل كائن time الوقت (المحلّي) في يوم غير محدّد، وهو عرضة للتعديل بواسطة كائن tzinfo. البنية العامة class datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0) المعاملات جميع المعاملات في عبارة إنشاء الصنف time اختيارية، وتأخذ القيمة الافتراضية 0، ويأخذ المعامل tzinfo القيمة الافتراضية None. يمكن أن تكون قيم جميع المعاملات (باستثناء المعامل tzinfo) أعدادًا صحيحة وضمن المديات التالية: ‎0 <= hour < 24‎ ‎0 <= minute < 60‎ ‎0 <= second < 60‎ ‎0 <= microsecond < 1000000‎ ‎fold in ...