إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
تطبيقات Canvas Copilot Studio Desktop تتدفق أعمدة صيغة Dataverse التطبيقات المستندة إلى النموذج وظائف Power Platform CLI Dataverse Power Pages
تحويل أية قيمة وتنسيق قيمة رقم أو تاريخ/وقت إلى سلسلة نصية.
الوصف
تقوم Text الدالة بتنسيق رقم أو قيمة تاريخ/وقت استنادا إلى أحد هذه الأنواع من الوسيطات:
- تنسيق تاريخ/وقت محدد مسبقا، والذي تحدده باستخدام تعداد DateTimeFormat. بالنسبة إلى التواريخ والأوقات ، يُفضل استخدام هذا الأسلوب لأنه يتم ضبطه تلقائيًا على لغة كل منطقة ومنطقتها.
- تنسيق مخصص ، يتألف من سلسلة من العناصر النائبة التي تحدد ، على سبيل المثال ، ما إذا كانت الأرقام تُظهر فاصل عشري وتواريخ تُظهر الاسم الكامل للشهر أو الشهر كاختصار أو الشهر كرقم. يدعم Power Apps مجموعه فرعيه من العناصر النائبة التي يدعمها Microsoft Excel. في هذه السلسلة ، يحدد العنصر النائب للغة اللغة التي يتم فيها ترجمة العناصر النائبة الأخرى. إذا كان التنسيق المخصص يتضمن فترة ، على سبيل المثال ، فإن العنصر النائب بتنسيق اللغة يحدد ما إذا كانت الفترة عبارة عن فاصل عشري (ja-JP) أو فاصل الآلاف (es-ES).
راجع التعامل مع التواريخ والأوقات للاطلاع على مزيد من المعلومات.
يمكن للدالة Text أيضا تحويل أي نوع بيانات إلى تمثيل نصي باستخدام تنسيق افتراضي. استخدم هذا لتمرير القيم غير النصية إلى الوظائف النصية مثل Len، وRight، وIsMatch.
تنسيقات التاريخ/الوقت المحددة مسبقا
النسبة لهذه الامثله ، فان التاريخ والوقت المستخدمان هو الثلاثاء ، 7 ابريل ، 2020 8:26:59.180 PM ، في المنطقة الزمنيه UTC-7 ساعة.
| تعداد DateTimeFormat | الوصف | أمثلة (استخدام en-US) |
|---|---|---|
| تاريخ طويل | السنه المكونة من أربعه أرقام واسم الشهر واليوم من الشهر واليوم من الأسبوع. أسماء الأشهر وأيام الأسبوع غير مختصره. | "الثلاثاء ، 7 ابريل 2020" |
| لونغديت تايم | السنة المكونة من أربعة أرقام واسم الشهر ويوم الشهر ويوم الأسبوع بالإضافة إلى الساعة (12 ساعة) والدقائق والثواني وتعيين ص/م. أسماء الأشهر وأيام الأسبوع غير مختصره. | "الثلاثاء، 7 أبريل، 2020 8:26:59 م" |
| لونغديت تايم24 | السنة المكونة من أربعة أرقام ، والشهر ، ويوم الشهر ، ويوم الأسبوع ، بالإضافة إلى الساعة (24 ساعة) والدقائق والثواني. أسماء الأشهر وأيام الأسبوع غير مختصره. | "الثلاثاء ، 7 أبريل ، 2020 20:26:59" |
| منذ فتره طويله | الساعة (12 ساعة) والدقائق والثواني وتعيين ص/م. | "8:26:59 م" |
| لونغ تايم24 | ساعة (24 ساعة) والدقائق والثواني. | "20:26:59" |
| تاريخ قصير | السنة المكونة من أربعة أرقام مع الشهر واليوم من الشهر. | "4/7/2020" |
| شورت ديت تايم | سنة مكونة من أربعة أرقام مع الشهر واليوم من الشهر ، بالإضافة إلى الساعة (12 ساعة) والدقائق وتعيين ص/م. | "4/7/2020 8:26 م" |
| شورت ديت تايم24 | سنة مكونة من أربعة أرقام مع الشهر واليوم من الشهر ، بالإضافة إلى الساعة (24 ساعة) والدقائق. | "4/7/2020 20:26" |
| وقت قصير | الساعة (12 ساعة) والدقائق وتعيين ص/م. | "8:26 م" |
| شورت تايم24 | ساعة (24 ساعة) والدقائق. | "20:26" |
| ت ع م | يتم تحويل قيمة التاريخ / الوقت إلى UTC بناءً على المنطقة الزمنية للمستخدم الحالي ويتم تنسيقها وفقًا لمعيار ISO 8601. | "2020-04-08T03:26:59.180Z" |
العناصر النائبة للأعداد
| عنصر نائب | الوصف |
|---|---|
| 0 (صفر) | يعرض أصفارًا غير ذات أهمية إذا كان الرقم يحتوي على أرقام أقل من الأصفار في التنسيق. على سبيل المثال، استخدم التنسيق #.00 إذا عرضت 8.9 كـ 8.90. |
| # | اتباع نفس القواعد مثل 0 (صفر). ومع ذلك، Text لا ترجع الأصفار الإضافية عندما يحتوي الرقم على أرقام أقل على أي من جانبي الرقم العشري من عدد الرموز في التنسيق. على سبيل المثال، يتم عرض 8.9 إذا كان التنسيق المخصص هو #.## ورقم التنسيق هو 8.9. |
| . (الفترة) | عرض العلامة العشرية في رقم ما. حسب لغة التنسيق المخصص؛ راجع التطبيقات العمومية للاطلاع على التفاصيل. |
| ، (فاصلة) | عرض فاصل التجميع في رقم، وغالبًا ما يُستخدم للآلاف. Text يفصل المجموعات بفواصل إذا كان التنسيق يحتوي على فاصلة محاطة بعلامات الأرقام (#) أو الأصفار. حسب لغة التنسيق المخصص؛ راجع التطبيقات العمومية للاطلاع على التفاصيل. |
إذا كان الرقم يحتوي على أرقام على يمين الفاصلة العشرية أكثر من العناصر النائبة في التنسيق ، يتم تقريب الرقم إلى عدد عشري مثل العناصر النائبة. إذا كانت هناك أرقام على يسار الفاصلة العشرية أكثر من العناصر النائبة ، فسيتم عرض الأرقام الإضافية. إذا احتوى التنسيق على علامات أرقام فقط (#) على يسار الفاصلة العشرية ، تبدأ الأرقام الأقل من 1 بعلامة عشرية (على سبيل المثال، .47).
العناصر النائبة للتاريخ والوقت
| عنصر نائب | الوصف |
|---|---|
| m | عرض الشهر كرقم بدون صفر بادئ. |
| mm | عرض الشهر كرقم بصفر بادئ عند الاقتضاء. |
| mmm | عرض الشهر كاختصار (ينا إلى ديس). |
| mmmm | عرض الشهر كاسم كامل (يناير إلى ديسمبر). |
| d | عرض اليوم كرقم بدون صفر بادئ. |
| dd | عرض اليوم كرقم بصفر بادئ عند الاقتضاء. |
| ddd | عرض اليوم كاختصار (أحد إلى سبت). |
| dddd | عرض اليوم كاسم كامل ( الأحد إلى السبت). |
| yy | عرض السنة كرقم من رقمين. |
| yyyy | عرض السنة كرقم من أربعة أرقام. |
| h | عرض الساعة كرقم بدون صفر بادئ. |
| hh | عرض الساعة كرقم بصفر بادئ عند الاقتضاء. إذا كان التنسيق يحتوي على AM أو PM، يتم عرض الساعة على أساس 12 ساعة. وبخلاف ذلك ، يتم عرض الساعة علي أساس 24 ساعة. |
| m | عرض الدقيقة كرقم بدون صفر بادئ. يجب أن يظهر هذا العنصر النائب مباشرة بعد رمز h أو hh أو مباشرة قبل رمز ss ؛ وإلا، Text فترجع الشهر بدلا من الدقائق. |
| mm | عرض الدقيقة كرقم بصفر بادئ عند الاقتضاء. يجب أن يظهر هذا العنصر النائب مباشرة بعد العنصر النائب h أو hh أو مباشرةً قبل العنصر النائب ss. وإلا، Text فترجع الشهر بدلا من الدقائق. |
| s | عرض الثانية كرقم بدون صفر بادئ. |
| ss | عرض الثانية كرقم بصفر بادئ عند الاقتضاء. |
| f | عرض كسور الثواني. |
| AM/PM,a/p | عرض الساعة علي أساس ساعة 12 ساعة. Text إرجاع "AM" أو "a" للأوقات من منتصف الليل حتى الظهر و"PM" أو "p" للأوقات من الظهر حتى منتصف الليل |
العناصر النائبة الحرفية
يمكنك تضمين اي من هذه الحروف في سلسله التنسيق الخاصة بك. ستظهر في نتيجة Text كما هي. يتم حجز الأحرف الإضافية للعناصر النائبة المستقبلية ، لذا لا يجب استخدامها.
| الحرف | الوصف |
|---|---|
| أي رمز عملة | علامة الدولار، علامة السنت، علامة اليورو، إلخ. |
| + | علامة الجمع |
| ( | قوس أيسر |
| : | علامة النقطتين |
| ^ | علامة الإدخال (علامة الإقحام) |
| ' | فاصلة |
| { | قوس متعرج أيسر |
| < | علامة أقل من |
| = | علامة تساوي |
| - | علامة ناقص |
| / | علامة الشرطة المائلة |
| ) | قوس أيمن |
| & | علامة العطف |
| ~ | التلدة |
| } | قوس متعرج أيمن |
| > | علامة أكبر من |
| حرف مسافة |
تطبيقات عمومية
الدالة Text مدركة عالميا. بالنسبة لمجموعة واسعة من اللغات ، فإنه يعرف كيفية كتابة التواريخ والأوقات والعملات والأرقام بشكل صحيح. للقيام بعملها ، فإنها تحتاج إلى معلومتين:
- لغة التنسيق المخصص: بالنسبة للصناع ، كيف يجب تفسير التنسيق المخصص؟ الحرفان الفاصلان (. و,) لديهما معانٍ مختلفة بلغات مختلفة. إذا حددت تنسيقًا مخصصًا ، فيمكنك تضمين عنصر نائب للغة أو أخذ القيمة الافتراضية ، والتي تعكس اللغة التي تم تعيين جهازك عليها. بشكل أسهل، يمكنك استخدام أحد تنسيقات التاريخ/الوقت المحددة سابقًا، التي تكون خاصة باللغة.
- لغة النتيجة: بالنسبة للمستخدمين ، بأي لغة يجب أن تظهر نتيجة الوظيفة؟ يجب أن تكون أسماء الأشهر وأسماء أيام الأسبوع باللغة المناسبة لمستخدم التطبيق، والتي يمكنك تحديدها بإضافة وسيطة اختيارية ثالثة إلى الدالة Text .
لكليهما ، يمكنك تحديد اللغة باستخدام علامة اللغة. للاطلاع على قائمة اللغات المعتمدة، اكتب Text( 1234، ""، ) في شريط الصيغة أو علامة التبويب خيارات متقدمة في الجزء الأيمن، ثم قم بالتمرير عبر قائمة الإعدادات المحلية المقترحة للوسيطة الثالثة.
عنصر نائب للغة
لتحديد اللغة الخاصة بالتنسيق المخصص ، استخدم:
| عنصر نائب | الوصف |
|---|---|
| [$-LanguageTag] | LanguageTag هي علامة لغة كما تم إرجاعها من الدالة Language . يمكنها تحديد اللغة فقط (مثل [$-en] للغة الإنجليزية)، أو يمكنها أيضًا تحديد المنطقة (مثل [$-en-GB] لتحديد بريطانيا العظمى بشكل أكبر). |
يمكن أن يظهر العنصر النائب للغة في أي مكان بالتنسيق المخصص ولكن مرة واحدة فقط.
إذا حددت تنسيقًا مخصصًا بدون عنصر نائب للغة وكان التنسيق غامضًا من وجهة نظر عامة ، فسيتم إدراج علامة اللغة الخاصة بلغتك الحالية تلقائيًا.
[$-en-us] إذا لم يكن هذا العنصر النائب موجودا عند تشغيل تطبيقك.
ملاحظة
في إصدار مستقبلي ، قد تتغير بنية هذا العنصر النائب لتجنب الخلط بينه وبين عنصر نائب مماثل ، ولكن مختلف ، يدعمه Excel.
علامة لغة النتيجة
تتضمن نتيجة Text السلاسل المترجمة للأشهر وأسابيع الأسبوع وتعيينات AM/PM، بالإضافة إلى المجموعة المناسبة والفواصل العشرية.
بشكل افتراضي، Text يستخدم لغة المستخدم الذي يقوم بتشغيل التطبيق. تقوم وظيفة Language بإرجاع علامة اللغة للمستخدم الحالي. يمكنك تجاوز هذه القيمة الافتراضية عن طريق توفير علامة لغة للوسيطة الثالثة إلى Text.
بناء الجملة
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - مطلوب. الرقم أو قيمه التاريخ/الوقت المراد تنسيقها.
- DateTimeFormat - مطلوب. عضو في تعداد DateTimeFormat.
- ResultLanguageTag - اختياري. علامة اللغة المراد استخدامها لنص النتيجة. بشكل افتراضي ، يتم استخدام لغة المستخدم الحالي.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- الرقم - مطلوب. الرقم أو قيمه التاريخ/الوقت المراد تنسيقها.
- CustomFormat - مطلوب. واحد أو أكثر من العناصر النائبة محاطة بعلامات اقتباس مزدوجة.
- ResultLanguageTag - اختياري. علامة اللغة المراد استخدامها لنص النتيجة. بشكل افتراضي ، يتم استخدام لغة المستخدم الحالي.
Text( AnyValue )
- AnyValue - مطلوب. القيمة المطلوب تحويلها إلى تمثيل نصي. يتم استخدام أحد التنسيقات الافتراضية.
Text ( ديناميكي )
- ديناميكي - مطلوب. القيمة الديناميكية التي تمثل سلسلة. تعتمد القيم المقبولة على الموفر غير المصنف. بالنسبة إلى JSON، إذا كانت القيمة الديناميكية رقما أو قيمة منطقية، تحويلها إلى نص.
الأمثلة
ما لم يتم تحديد خلاف ذلك ، فإن المستخدم الذي يشغل هذه الصيغ موجود في الولايات المتحدة وقد اختار اللغة الإنجليزية كلغته. تقوم وظيفة Language بإرجاع "en-US".
الرقم
| صيغة | الوصف | نتيجة |
|---|---|---|
| Text( 1234.59, "####.#" ) | تنسيق الرقم بمنزلة عشرية واحدة. | "1234.6" |
| Text( 8.9, "#.000" ) | حشو الجزء العشري من الرقم بأصفار زائدة، إذا لزم الأمر. | "8.900" |
| Text( 0.631, "0.#" ) | حشو الجزء بالكامل من الرقم بالأصفار البادئة ، إذا لزم الأمر. | "0.6" |
|
Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
حشو الجزء العشري من الرقم بالأصفار لمكان عشري واحد ، ويتضمن مكانًا عشريًا ثانيًا إذا تم توفيره. | "12.0" "1234.57" |
|
Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
وضع فاصل الآلاف كل ثلاثة أرقام، ويتضمن رمز العملة. | "12,000 دولار" "1,200,000 دولار" |
التاريخ/الوقت
- في 2:37:47 م في الإثنين 23 نوفمبر 2015
- الولايات المتحدة - التوقيت الباسيفيكي (UTC-8)
| صيغة | الوصف | نتيجة |
|---|---|---|
| Text( الآن()، DateTimeFormat.LongDate ) | التنسيقات كسلسلة تاريخية طويلة ، بلغة ولغة المستخدم الحالي. | "الإثنين، 23 نوفمبر، 2015" |
| Text( الآن()، DateTimeFormat.LongDateTime ) | التنسيقات كسلسلة تاريخ ووقت طويلة ، بلغة ولغة المستخدم الحالي ، باستخدام ساعة 12 ساعة. | "الإثنين، 23 نوفمبر، 2015 2:37:47 م" |
| Text( الآن()، DateTimeFormat.LongTime24 ) | التنسيقات كسلسلة زمنية طويلة ، باستخدام ساعة 24 ساعة. | "14:37:47" |
| Text( الآن()، DateTimeFormat.ShortDate ) | التنسيقات كسلسلة تاريخية قصيرة، بلغة ولغة المستخدم الحالي. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | التنسيقات التي تستخدم أحرف العنصر النائب:
|
"23 نوفمبر 2015" |
| Text(1448318857*1000، "mmm. dd, yyyy (hh:mm:ss AM/PM)") | يعرض قيمة وقت تاريخ Unix بتنسيق يمكن قراءته من قبل الإنسان إذا قمت بضرب قيمة المصدر في 1,000. | "23 نوفمبر 2015 (02:47:37 م)" |
تطبيقات عمومية
| صيغة | الوصف | نتيجة |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | يعرض مسافة كفاصل تجميع، والفاصلة كفاصل عشري، وكرمز € العملة. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | إذا كانت بيانات المصدر تتبع العرف الفرنسي باستخدام فاصلة كفاصل عشري ، فيجب عليك تغيير الإعدادات المحلية إلى الفرنسية وفصل الوسيطات بفاصلة منقوطة بدلاً من الفاصلة للحصول على نفس النتيجة المذكورة أعلاه. | "1 234 567,89 €" |
| Text( التاريخ(2016,1,31), "dddd mmmm d" ) | إرجاع أيام الأسبوع والشهر ويوم الشهر بلغة المستخدم الحالي. نظرًا لعدم اعتماد أي عنصر نائب على اللغة، فلا توجد حاجة إلى علامة لغة نص التنسيق. | "الأحد 31 يناير" |
| Text( التاريخ(2016,1,31), "dddd mmmm d", "es-ES" ) | إرجاع أيام الأسبوع والشهر ويوم الشهر بلغة "es-ES". | "domingo enero 31" |
تحويل قيم إلى نص
| صيغة | الوصف | نتيجة |
|---|---|---|
| Text( 1234567.89 ) | تحويل رقم إلى سلسلة. لا يوجد آلاف الفواصل أو التحكم في عدد الأرقام قبل أو بعد الفاصل العشري ؛ لمزيد من التحكم ، قم بتوفير العناصر النائبة لرقم العرض كوسيطة ثانية. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | تحويل قيمة التاريخ/الوقت إلى سلسلة نصية. للتحكم في التحويل، قم بتوفير عضو في تعداد DateTimeFormat أو سلسلة تنسيق مخصص. | "1/4/2003 12:00 ص" |
| Text( صحيح ) | تحويل قيمة منطقية إلى سلسلة. | "صواب" |
| Text( GUID() ) | تحويل قيمة GUID تم إنشاؤها إلى سلسلة. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | إرجاع الأحرف الأربعة الأولى من GUID الذي تم إنشاؤه. | "2d9c" |