DateValueالدالات TimeValueو و DateTimeValue

ينطبق على: تعمل تطبيقات Canvas Copilot Studio Desktop على تدفقات التطبيقات المستندة إلى نموذج Power Platform CLI Dataverse لوظائف Power Pages

تحويل التاريخ أو الوقت أو كليهما في سلسلة إلى قيمة التاريخ/الوقت.

‏‏الوصف

• DateValue تحول الدالة سلسلة تاريخ (مثل "10/01/2014") إلى قيمة تاريخ/وقت .

• TimeValue تحول الدالة سلسلة زمنية (مثل "12:15 م") إلى قيمة تاريخ/وقت .

• DateTimeValue تحول الدالة سلسلة تاريخ ووقت (مثل "10 يناير 2013 12:13 ص") إلى قيمة تاريخ/وقت .

DateValue تتجاهل الدالة أي معلومات وقت في سلسلة التاريخ، وتتجاهل TimeValue الدالة أي معلومات تاريخ في السلسلة الزمنية.

‏‫ملاحظة‬

DateValue TimeValueتستخدم الدالات و و DateTimeValue بشكل افتراضي اللغة من إعدادات المستخدم الحالي. يمكنك تجاوزها للتأكد من تفسير السلاسل بشكل صحيح. على سبيل المثال، يتم تفسير "10/1/1920" على أنه 1 أكتوبر في "en" و10 يناير في "fr".

يجب أن تستخدم التواريخ أحد هذه التنسيقات:

• MM/DD/YYYY أو MM-DD-YYYY
• DD/MM/YYYY أو DD-MM-YYYY
• YYYY/MM/DD أو YYYY-MM-DD
• MM/DD/YY أو MM-DD-YY
• DD/MM/YY أو DD-MM-YY
• DD Mon YYYY
• شهر DDو YYYY

للتحويل من مكونات التاريخ والشهر والسنة، اقرأ Date.
للتحويل من المكونات الرقمية للساعة والدقيقة والثانية، اقرأ Time.

لمزيد من المعلومات، راجع:

• العمل باستخدام التاريخ والوقت
• أنواع البيانات والتاريخ/الوقت

بناء الجملة

DateValue( سلسلة [، اللغة] )
DateTimeValue( سلسلة [، اللغة ] )
TimeValue( سلسلة [، اللغة ] )

• سلسلة - مطلوب. سلسلة نصية تحتوي على قيمة تاريخ أو وقت أو تركيبة التاريخ والوقت.
• اللغة - اختياري. سلسلة لغة، مثل التي سيتم إرجاعها بأول حرفين من وظيفة Language. في حالة عدم توفيرها، يتم استخدام لغة إعدادات المستخدم الحالية.

DateValue( ديناميكي )
DateTimeValue( ديناميكي )
TimeValue( ديناميكي )

• ديناميكي - مطلوب. القيمة الديناميكية التي تمثل تاريخا أو وقتا. تعتمد القيم المقبولة على الموفر غير المصنف. بالنسبة إلى JSON، من المتوقع أن تكون القيمة الديناميكية سلسلة JSON تحتوي على تاريخ ووقت بتنسيق ISO 8601. تؤدي التواريخ أو الأوقات بتنسيقات أخرى إلى حدوث خطأ. يمكنك تحويل هذه القيم إلى نص أولاً، ثم إلى تاريخ أو وقت. ضع في اعتبارك أن المناطق الزمنية والتنسيقات المرتبطة بالإعدادات المحلية هي اعتبارات هامة عند الاتصال بأنظمة خارجية.

الأمثلة

DateValue

إذا قمت بكتابة 10/11/2014في عنصر تحكم إدخال النص المسمى Startdate، ثم قم بتعيين خاصية Text لتسمية إلى تلك الصيغ:

• تحويل تاريخ من سلسلة في لغة المستخدم المحلية وإظهار النتيجة كتاريخ طويل.

  Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )
  

  يعرض الجهاز المعين إلى لغة en المحلية التسمية كـ السبت، 11 أكتوبر 2014.

  ‏‫ملاحظة‬

  يمكنك استخدام العديد من الخيارات مع تعداد DateTimeFormat. لعرض قائمة بالخيارات، اكتب المعلمة متبوعةً بنقطة (.) في شريط الصيغة أو افحص مرجع وظيفة Text.

• تحويل تاريخ من سلسلة في اللغة الفرنسية المحلية وإظهار النتيجة كتاريخ طويل. في هذا المثال، يتم تفسير الأشهر ويوم الشهر بشكل مختلف عن اللغة الإنجليزية.

  Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )
  

  يعرض الجهاز المعين إلى لغة en المحلية التسمية كـ الإثنين، 10 نوفمبر 2014.

إذا أدخلت 20 أكتوبر 2014 بدلا من ذلك:

• قم بتحويل تاريخ من سلسلة في لغة المستخدم وحساب الفرق بين يومين، في الأيام

  DateDiff( DateValue( Startdate.Text ), Today() )
  

  يعرض الجهاز المعين إلى لغة en المحلية التسمية كـ 9، للإشارة إلى عدد الأيام بين 11 أكتوبر و20 أكتوبر. كما يمكن لوظيفة DateDiff إظهار الفرق بالأشهر أو الفصول أو السنوات.

DateTimeValue

إذا قمت بكتابة 10/11/2014 الساعة 1:50:24.765 مساءً في عنصر تحكم إدخال النص المسمى البدء، ثم قم بتعيين خاصية Text للتسمية إلى الصيغة التالية:

• قم بتحويل كل من سلسلة التاريخ والوقت في اللغة الحالية.

  Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )
  

  يعرض الجهاز المعين إلى لغة en المحلية التسمية كـ السبت، 11 أكتوبر 2014 الساعة 1:50:24 مساءً.

  ‏‫ملاحظة‬

  يمكنك استخدام العديد من الخيارات مع تعداد DateTimeFormat. لعرض قائمة بالخيارات، اكتب المعلمة متبوعةً بنقطة (.) في شريط الصيغة أو افحص مرجع وظيفة Text.

• قم بتحويل كل من سلسلة التاريخ والوقت في اللغة الفرنسية المحلية. يتم تفسير الشهر واليوم من الشهر بشكل مختلف.

  Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )
  

  يعرض الجهاز المعين إلى لغة en المحلية التسمية كـ الإثنين، 10 نوفمبر 2014 الساعة 1:50:24 مساءً.

• قم بتحويل كل من سلسلة التاريخ والوقت في لغة المستخدم المحلي، واعرض النتيجة في جزء من الثانية.

  Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )
  

  يعرض الجهاز المعين إلى لغة en المحلية التسمية كـ السبت، 11 أكتوبر 2014 الساعة 01:50:24.765 مساءً.

  وكبديل لذلك، يمكنك تحديد hh:mm:ss.f أو hh:mm:ss.ff لتقريب الوقت إلى أقرب 10 أو 100 جزء من الثانية.

TimeValue

قم بتسمية عنصر تحكم إدخال النص FinishedAt، وقم بتعيين خاصية Text لتسمية إلى هذه الصيغة:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)

• إذا كتبت 4:59:59.999 PM في عنصر تحكم FinishedAt، تعرض التسمية "لقد قمت بذلك!"
• إذا كتبت 5:00:00.000 PM في عنصر تحكم FinishedAt، تعرض التسمية "متأخر جدًا!"