Dateالدالات DateTimeو و Time

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

تحويل مكونات التاريخ والوقت إلى قيمة تاريخ/وقت.

الوصف

Date تحول الدالة قيم السنة والشهر واليوم الفردية إلى Dateقيمة /Time . جزء الوقت هو منتصف الليل.

• إذا كانت السنة بين 0 و1899 (شامل الرقمين)، تضيف الوظيفة هذه القيمة إلى 1900 لحساب السنة. 70 يصبح 1970.
• إذا كان الشهر أقل من 1 أو أكثر من 12، فإن النتيجة تطرح أو تضيف العديد من الأشهر من بداية السنة المحددة.
• إذا كان اليوم أكبر من عدد الأيام في الشهر المحدد، تضيف الوظيفة العديد من الأيام إلى اليوم الأول من الشهر وتُرجع التاريخ المقابل من شهر لاحق. إذا كان اليوم أقل من 1، تطرح الوظيفة العديد من الأيام، بالإضافة إلى 1، من اليوم الأول من الشهر المحدد.

Time تحول الدالة القيم الفردية Hour و Minute و Second واختياريا مللي ثانية إلى Dateقيمة /Time . ولا يكون للنتيجة أي تواريخ مقترنة بها.

DateTime تجمع الدالة Date بين الدالتين و Time في دالة واحدة، مع أخذ وسيطات التاريخ والوقت وإرجاع Dateقيمة /Time تحتوي على مكونات التاريخ والوقت.

راجع قيم DateValue، وTimeValue، وDateTimeValue للحصول على معلومات حول كيفية تحويل سلسلة إلى قيمة.

راجع أيضًا التعامل مع التواريخ والأوقات للاطلاع على مزيد من المعلومات.

بناء الجملة

Date( سنة، شهر، يوم )

• السنة - مطلوب. يتم تفسير الأرقام الأكبر من 1899 على أنها مطلقة (يتم تفسير 1980 على أنه 1980)؛ يتم تفسير الأرقام التي تتراوح من 0 إلى 1899 على أنها تتعلق بـ 1900. (على سبيل المثال، يتم تفسير 80 على أنه 1980.)
• الشهر - مطلوب. رقم يتراوح من 1 إلى 12.
• اليوم - مطلوب. رقم يتراوح من 1 إلى 31.

Time( ساعة، دقيقة، ثانية [، مللي ثانية ] )

• ساعة - مطلوبة. عدد الساعات، عادة ما يكون في النطاق 0 (12:00 صباحا) إلى 23 (11:00 PM).
• دقيقة - مطلوب. عدد الدقائق، عادةً ما يكون في النطاق من 0 إلى 59.
• ثانيا - مطلوب. عدد الثواني، عادةً ما يكون في النطاق من 0 إلى 59.
• ميلي ثانية - اختياري. عدد المللي ثانية، عادةً ما يكون في النطاق من 0 إلى 999.

DateTime( سنة، شهر، يوم، ساعة، دقيقة، ثانية [، مللي ثانية ] )

• السنة - مطلوب. يتم تفسير الأرقام الأكبر من 1899 على أنها مطلقة (يتم تفسير 1980 على أنه 1980)؛ يتم تفسير الأرقام التي تتراوح من 0 إلى 1899 على أنها تتعلق بـ 1900. (على سبيل المثال، يتم تفسير 80 على أنه 1980.)
• الشهر - مطلوب. رقم يتراوح من 1 إلى 12.
• اليوم - مطلوب. رقم يتراوح من 1 إلى 31.
• ساعة - مطلوبة. عدد الساعات، عادةً ما يكون في النطاق من 0 (12:00 صباحًا) إلى 23 (11:00 مساءً)
• دقيقة - مطلوب. عدد الدقائق، عادةً ما يكون في النطاق من 0 إلى 59.
• ثانيا - مطلوب. عدد الثواني، عادةً ما يكون في النطاق من 0 إلى 59.
• ميلي ثانية - اختياري. عدد المللي ثانية، عادةً ما يكون في النطاق من 0 إلى 999.

الأمثلة

Date

إذا كان أحد المستخدمين قد قام بكت

• 1979 في عنصر تحكم إدخال النص المسمى HireYear
• 3 في عنصر تحكم إدخال نص يسمى HireMonth
• 17 في عنصر تحكم إدخال النص المسمى HireDay

ستعود هذه الصيغة 3/17/1979:

Date( Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text) )

Time

إذا كان أحد المستخدمين قد قام بكت

• 14 في عنصر تحكم إدخال نص يسمى BirthHour
• 50 في عنصر تحكم إدخال نص يسمى BirthMinute
• 24 في عنصر تحكم إدخال النص المسمى BirthSecond

ستعود هذه الصيغة 02:50:24 P:

Text( 
    Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), 
    "hh:mm:ss A/P" 
)

DateTime

إذا كان أحد المستخدمين قد قام بكت

• 2023 في عنصر تحكم إدخال النص المسمى EclipseYear
• 10 في عنصر تحكم إدخال النص المسمى EclipseMonth
• 28 في عنصر تحكم إدخال النص المسمى EclipseDate
• 13 في عنصر تحكم إدخال النص المسمى EclipseHour
• 14 في عنصر تحكم إدخال النص المسمى EclipseMinute
• 5 في عنصر تحكم إدخال نص يسمى EclipseSecond
• 231 في عنصر تحكم إدخال النص المسمى EclipseMillisecond

ستعود هذه الصيغة 10/28/23 01:14:05.231 PM:

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)