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

مقالة
06/10/2024

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

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

‏‏الوصف

تقوم وظيفة 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 860. سينتج عن التواريخ أو الأوقات بتنسيقات أخرى خطأ. يمكنك تحويل هذه القيم إلى نص أولاً، ثم إلى تاريخ أو وقت. ضع في اعتبارك أن المناطق الزمنية والتنسيقات المرتبطة بالإعدادات المحلية هي اعتبارات هامة عند الاتصال بأنظمة خارجية.

الأمثلة

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، تعرض التسمية "متأخر جدًا!"

مشاركة عبر