الفرق بين المراجعتين ل"Python/datetime/date/fromisoformat"

من موسوعة حسوب
< Python‏ | datetime‏ | date
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>date.fromisofromat()‎</code> في بايثون}}</noinclude> يعيد التابع التاريخ الموافق لسلسل...')
 
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE:الصنف <code>date.fromisofromat()‎</code> في بايثون}}</noinclude>
 
<noinclude>{{DISPLAYTITLE:الصنف <code>date.fromisofromat()‎</code> في بايثون}}</noinclude>
  
يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع date.isoformat()‎.
+
يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع <code>[[Python/datetime/date/isoformat|date.isoformat()]]</code>‎.
  
 
== البنية العامة ==
 
== البنية العامة ==
سطر 12: سطر 12:
 
=== <code>date_string</code> ===
 
=== <code>date_string</code> ===
  
سلسلة نصية تتضمّن التاريخ المطلوب تحويله إلى كائن date، وتتبع السلسلة النصية الصيغة <code>YYYY-MM-DD</code>.
+
سلسلة نصية تتضمّن التاريخ المطلوب تحويله إلى كائن <code>date</code>، وتتبع السلسلة النصية الصيغة <code>YYYY-MM-DD</code>.
  
 
== القيمة المعادة ==
 
== القيمة المعادة ==
  
كائن date يكون التاريخ فيه موافقًا للتاريخ المعطى في السلسلة النصية date_string.
+
كائن <code>date</code> يكون التاريخ فيه موافقًا للتاريخ المعطى في السلسلة النصية <code>date_string</code>.
  
'''تنبيه''': لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع date.isoformat()‎.
+
'''تنبيه''': لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع <code>[[Python/datetime/date/isoformat|date.isoformat()‎]]</code>.
  
 
'''ملاحظة''': هذا التابع جديد في الإصدار 3.7 من اللغة.
 
'''ملاحظة''': هذا التابع جديد في الإصدار 3.7 من اللغة.

المراجعة الحالية بتاريخ 07:54، 5 يوليو 2018


يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع date.isoformat()‎.

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

date.fromisoformat(date_string)

المعاملات

date_string

سلسلة نصية تتضمّن التاريخ المطلوب تحويله إلى كائن date، وتتبع السلسلة النصية الصيغة YYYY-MM-DD.

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

كائن date يكون التاريخ فيه موافقًا للتاريخ المعطى في السلسلة النصية date_string.

تنبيه: لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع date.isoformat()‎.

ملاحظة: هذا التابع جديد في الإصدار 3.7 من اللغة.

أمثلة

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

>>> from datetime import date
>>> t = date.fromisoformat("2018-07-05")
>>> print(t)
2018-07-05
>>> t
datetime.date(2018, 7, 5)

انظر أيضًا

  • التابع date.today()‎ : يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية.
  • التابع date.fromtimestamp(): يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغة POSIX كالذي يعيده التابع time.time()‎.

مصادر

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