الدالات Now، وToday، وIsToday، وUTCNow، وUTCToday، وIsUTCToday

ينطبق على: تطبيقات قماش تدفقات سطح المكتب Dataverse اعمدة الصيغة التطبيقات المستندة إلى النماذج Power Platform CLI

إرجاع التاريخ والوقت الحاليين واختبار ما إذا كانت قيمة التاريخ / الوقت اليوم.

‏‫ملاحظة

لا تدعم أوامر PAC ISAC pac power-المركزية وظائف UTCNowو UTCTodayو sUTCToday. الوظيفة

الوصف

تقوم وظيفة Now بإرجاع التاريخ والوقت الحاليين كقيمة تاريخ/وقت.

تقوم وظيفة Today بإرجاع التاريخ الحالي كقيمة تاريخ/وقت. جزء الوقت هو منتصف الليل. تحتوي وظيفة Today على نفس القيمة طوال اليوم، وذلك من منتصف الليل اليوم إلى منتصف الليل غدًا.

تختبر وظيفة IsToday ما إذا كانت قيمة التاريخ / الوقت بين منتصف الليل اليوم ومنتصف الليل غدًا. تُرجع هذه الوظيفة قيمة منطقية (صواب أو خطأ).

تعمل الدوال Now، وToday، وIsToday مع إعدادات المستخدم المحلية الحالية للوقت.

تُعد الدوالUTCNow، و UTCToday، و IsUTCToday هي نفس الدول التي لا تتبع التوقيت العالمي المنسق ولكنها تعمل مع قيم مستقلة عن المنطقة الزمنية وتستخدم التوقيت العالمي المتفق عليه (UTC).

‏‫ملاحظة‬

• لا تتوفر الدوال UTCNow، وUTCToday، وIsUTCToday إلا في أعمدة الصيغة Microsoft Dataverse for Teams، ولا تتوفر إلا في الحقول والقيم المستقلة عن المنطقة الزمنية فقط.
• لا تتوفر الدوال Now، وToday، وIsToday في أعمدة الصيغة Dataverse for Teams حيث يتم إجراء عمليات تقييم دون معرفة إعدادات المنطقة الزمنية المحلية للمستخدم الحالي.
  مزيد من المعلومات: العمل مع أعمدة جدول الصيغة في Dataverse for Teams

لمزيد من المعلومات، راجع التاريخ والوقت والدالة DateTime في وثائق أنواع البيانات والعمل مع التواريخ والأوقات.

الدالات المتغيرة

تعتبر الدوال Now، وToday، وUTCNow، وUTCToday دوال متغيرة. تُرجع هذه الدوال قيمة مختلفة لكل تقييم.

عند استخدامها في صيغة تدفق البيانات، لن تُرجع الدالة المتغيرة قيمة مختلفة إلا إذا أعيد تقييم الصيغة التي تظهر فيها. إذا لم يتغير أي شيء آخر في الصيغة، فستكون له نفس القيمة طوال تنفيذ تطبيقك.

على سبيل المثال، لا يتغير عنصر تحكم التسمية بـ Label1.Text = Now() عندما يكون التطبيق الخاص بك نشطًا. سيؤدي إغلاق التطبيق وإعادة فتحه فقط إلى قيمة جديدة.

ستتم إعادة تقييم الوظيفة إذا كانت جزءًا من صيغة تغير فيها شيء آخر. على سبيل المثال ، إذا قمنا بتغيير مثالنا ليشمل عنصر تحكم شريط التمرير مع Label1.Text = DateAdd( Now(), Slider1.Value, Minutes ) فإنه يتم استرداد الوقت الحالي في كل مرة تتغير فيها قيمة عنصر تحكم شريط التمرير ويتم تقييم خاصية نص التسمية.

عند استخدامها في صيغة سلوك، سيتم تقييم الوظائف المتغيرة في كل مرة يتم فيها تقييم صيغة السلوك. راجع ما يلي للاطلاع على مثال.

بناء الجملة

استخدم إعدادات المستخدم المحلية للوقت

Now()

Today()

IsToday( DateTime )

• DateTime - مطلوب. قيمه التاريخ/الوقت المطلوب اختبارها.

استخدم التوقيت العالمي المتفق عليه (UTC)

UTCNow()

UTCToday()

IsUTCToday( TimeZoneIndependentTime )

• TimeZoneIndependentDateTime - مطلوب. قيمة التاريخ/الوت المستقلة عن المنطقة الزمنية لغرض الاختبار.

الأمثلة

بالنسبة لأمثلة هذا القسم، الوقت الحالي هو 8:58 م يوم 11 يوليو 2021 في المنطقة الزمنية الباسيفيكية (UTC-8) واللغة هي en-us.

الصيغة	الوصف	نتيجة
Text( Now(), "mm/dd/yyyy hh:mm:ss" )	قم باسترداد التاريخ والوقت الحاليين في المنطقة الزمنية للمستخدم وعرضه كسلسلة.	"07/11/2021 20:58:00"
Text( Today(), "mm/dd/yyyy hh:mm:ss" )	استرداد التاريخ الحالي فقط، وترك جزء الوقت في منتصف الليل، وعرضه كسلسلة.	"07/12/2021 00:00:00"
IsToday( Now() )	اختبار ما إذا كان التاريخ والوقت الحاليين بين منتصف الليل اليوم ومنتصف الليل غدًا.	true
IsToday( Today() )	اختبار ما إذا كان التاريخ الحالي بين منتصف الليل اليوم ومنتصف الليل غدًا.	true
Text( DateAdd( Now(), 12 ), "mm/dd/yyyy hh:mm:ss" )	استرداد التاريخ والوقت الحالي، وإضافة 12 يومًا إلى النتيجة، وعرضها كسلسلة.	"07/23/2021 20:58:00"
Text( DateAdd( Today(), 12 ), "mm/dd/yyyy hh:mm:ss" )	استرداد التاريخ الحالي، وإضافة 12 يومًا إلى النتيجة، وعرضه كسلسلة.	"07/23/2021 00:00:00"
IsToday( DateAdd( Now(), 12 ) )	اختبار ما إذا كان التاريخ والوقت الحاليان، بالإضافة إلى 12 يومًا، بين منتصف الليل اليوم ومنتصف الليل غدًا.	false
IsToday( DateAdd( Today(), 12 ) )	اختبار ما إذا كان التاريخ الحالي، بالإضافة إلى 12 يومًا، بين منتصف الليل اليوم ومنتصف الليل غدًا.	false
Hour( UTCNow() )	قم باسترداد التاريخ والوقت الحاليين في UTC واستخرج الساعة فقط، أي الساعة 8 بالتوقيت المحلي.	4
Day( UTCToday() )	استرداد التاريخ الحالي فقط بالتنسيق العالمي المتفق عليه (UTC) واستخرج اليوم، والذي يكون قبل التوقيت المحلي بـ 1 يوم.	12
IsUTCToday( UTCNow() )	اختبر ما إذا كان التاريخ والوقت الحاليين بين منتصف ليل اليوم ومنتصف ليل الغد، وكل ذلك حسب توقيت UTC.	true
IsUTCToday( UTCToday() )	اختبر ما إذا كان التاريخ الحالي بين منتصف ليل اليوم ومنتصف ليل الغد، وكل ذلك حسب توقيت UTC.	true

عرض ساعة يتم تحديثها في الوقت الفعلي

1. أضف عنصر تحكم Timer، وقم بتعيين خاصية Duration الخاصة به إلى 1000، وقم بتعيين خاصية Repeat الخاصة به إلى true.

   سيتم تشغيل المؤقت لمدة ثانية واحدة، ويبدأ تلقائيًا من جديد، ويستمر في هذا النمط.

2. عيّن خاصية OnTimerEnd‎‏‎‎ لعنصر التحكم إلى هذه الصيغة.

   Set( CurrentTime, Now() )

   عندما يبدأ الموقت من جديد (بعد كل ثانية)، تحدد هذه الصيغة المتغير العالمي CurrentTime إلى القيمة الحالية لوظيفة Now.

   

3. أضف عنصر تحكم Label،وقم بتعيين خاصية Text الخاصة به إلى هذه الصيغة:

   Text( CurrentTime, LongTime24 )

   استخدم وظيفة Text لتنسيق التاريخ والوقت كيفما تريد، أو قم بتعيين هذه الخاصية إلى فقط CurrentTime لإظهار الساعات والدقائق وليس الثواني.

   

4. عاين التطبيق بالضغط على F5، ثم ابدأ تشغيل المؤقت بالنقر فوقه أو الضغط عليه.

   يعرض الملصق باستمرار الوقت الحالي ، وصولاً إلى الثاني.

   

5. قم بتعيين خاصية AutoStart الخاصة بالمؤقت إلى صواب وخاصية Visible الخاصة به إلى خطأ.

   المؤقت غير مرئي ويبدأ تلقائيًا.

6. قم بتعيين خاصية OnStart الخاصة بالشاشة بحيث يحتوي متغير CurrentTime على قيمة صالحة، كما في هذا المثال:

   Set(CurrentTime, Now())

   تظهر التسمية بمجرد بدء التطبيق (قبل تشغيل المؤقت لمدة ثانية كاملة).