التابع `datetime.now()‎` في بايثون

يعيد التابع الوقت التاريخ الحاليين حسب الإعدادات المحليّة.

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

‎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 في توثيق بايثون الرسمي.