الفرق بين المراجعتين لصفحة: «Python/datetime/datetime/now»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>datetime.now()</code> في بايثون}}</noinclude> يعيد التابع الوقت التاريخ الحاليين...' |
لا ملخص تعديل |
||
| سطر 11: | سطر 11: | ||
== المعاملات == | == المعاملات == | ||
=== <code>tz</code> === | === <code>tz</code> === | ||
إن أخذ المعامل الاختياري tz القيمة None أو لم تحدّد له أيّة قيمة، فإنّ التابع يصبح مشابهًا للتابع today() | إن أخذ المعامل الاختياري <code>tz</code> القيمة <code>None</code> أو لم تحدّد له أيّة قيمة، فإنّ التابع يصبح مشابهًا للتابع <code>today()</code>، ولكن إن كان متوفّرًا فإنّه يقدّم دقّة تفوق تلك التي يمكن الحصول عليها باستخدام الختم الزمني الذي ينشئه التابع <code>time.time()</code> (على سبيل المثال، يمكن ذلك في المنصّات التي تدعم الدالة <code>gettimeofday()</code> في لغة C). | ||
إن لم يأخذ المعامل tz القيمة | إن لم يأخذ المعامل <code>tz</code> القيمة <code>None</code>، فإنّه يجب أن يكون نسخة من صنف <code>tzinfo</code> فرعي، ويجري تحويل الوقت والتاريخ الحاليين إلى المنطقة الزمنية المعطاة. في هذه الحالة تكون النتيجة مكافئة لنتيجة التعبير <code>tz.fromutc(datetime.utcnow().replace(tzinfo=tz))</code>. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
| سطر 35: | سطر 35: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* التابع <code>[[Python/datetime/datetime/today|datetime.today()]]</code>: يعيد التابع الوقت والتاريخ حسب التوقيت المحلّي، مع إعطاء المعامل <code>tzinfo</code> القيمة <code>None</code>. | |||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 16:13، 5 يوليو 2018
يعيد التابع الوقت التاريخ الحاليين حسب الإعدادات المحليّة.
البنية العامة
datetime.now(tz=None)
المعاملات
tz
إن أخذ المعامل الاختياري tz القيمة None أو لم تحدّد له أيّة قيمة، فإنّ التابع يصبح مشابهًا للتابع today()، ولكن إن كان متوفّرًا فإنّه يقدّم دقّة تفوق تلك التي يمكن الحصول عليها باستخدام الختم الزمني الذي ينشئه التابع time.time() (على سبيل المثال، يمكن ذلك في المنصّات التي تدعم الدالة gettimeofday() في لغة C).
إن لم يأخذ المعامل tz القيمة None، فإنّه يجب أن يكون نسخة من صنف tzinfo فرعي، ويجري تحويل الوقت والتاريخ الحاليين إلى المنطقة الزمنية المعطاة. في هذه الحالة تكون النتيجة مكافئة لنتيجة التعبير tz.fromutc(datetime.utcnow().replace(tzinfo=tz)).
القيمة المعادة
يعيد التابع الوقت والتاريخ الحاليين حسب الإعدادات المحلية.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> from datetime import datetime
>>> today = datetime.today()
>>> print(today)
2018-07-05 17:45:50.451453
>>> now = datetime.now()
>>> print(now)
2018-07-05 17:59:35.723470
انظر أيضًا
- التابع
datetime.today(): يعيد التابع الوقت والتاريخ حسب التوقيت المحلّي، مع إعطاء المعاملtzinfoالقيمةNone.
مصادر
قسم datetime Objects في صفحة Basic date and time types في توثيق بايثون الرسمي.