الدالة Text
ينطبق على:
تطبيقات قماش تدفقات سطح المكتب Dataverse اعمدة الصيغة التطبيقات المستندة إلى النماذج Power Platform CLI
تحويل أية قيمة وتنسيق قيمة رقم أو تاريخ/وقت إلى سلسلة نصية.
الوصف
تقوم وظيفة 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) |
|---|---|---|
| LongDate | السنه المكونة من أربعه أرقام واسم الشهر واليوم من الشهر واليوم من الأسبوع. أسماء الأشهر وأيام الأسبوع غير مختصره. | "الثلاثاء ، 7 ابريل 2020" |
| LongDateTime | السنة المكونة من أربعة أرقام واسم الشهر ويوم الشهر ويوم الأسبوع بالإضافة إلى الساعة (12 ساعة) والدقائق والثواني وتعيين ص/م. أسماء الأشهر وأيام الأسبوع غير مختصره. | "الثلاثاء، 7 أبريل، 2020 8:26:59 م" |
| LongDateTime24 | السنة المكونة من أربعة أرقام ، والشهر ، ويوم الشهر ، ويوم الأسبوع ، بالإضافة إلى الساعة (24 ساعة) والدقائق والثواني. أسماء الأشهر وأيام الأسبوع غير مختصره. | "الثلاثاء ، 7 أبريل ، 2020 20:26:59" |
| LongTime | الساعة (12 ساعة) والدقائق والثواني وتعيين ص/م. | "8:26:59 م" |
| LongTime24 | ساعة (24 ساعة) والدقائق والثواني. | "20:26:59" |
| ShortDate | السنة المكونة من أربعة أرقام مع الشهر واليوم من الشهر. | "4/7/2020" |
| ShortDateTime | سنة مكونة من أربعة أرقام مع الشهر واليوم من الشهر ، بالإضافة إلى الساعة (12 ساعة) والدقائق وتعيين ص/م. | "4/7/2020 8:26 م" |
| ShortDateTime24 | سنة مكونة من أربعة أرقام مع الشهر واليوم من الشهر ، بالإضافة إلى الساعة (24 ساعة) والدقائق. | "4/7/2020 20:26" |
| ShortTime | الساعة (12 ساعة) والدقائق وتعيين ص/م. | "8:26 م" |
| ShortTime24 | ساعة (24 ساعة) والدقائق. | "20:26" |
| UTC | يتم تحويل قيمة التاريخ / الوقت إلى 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 بإرجاع "ص" أو "a" للأوقات من منتصف الليل حتى الظهر و"م" أو "p" للأوقات من الظهر حتى منتصف الليل |
العناصر النائبة الحرفية
يمكنك تضمين اي من هذه الحروف في سلسله التنسيق الخاصة بك. ستظهر في نتيجة Text كما هي. يتم حجز الأحرف الإضافية للعناصر النائبة المستقبلية ، لذا لا يجب استخدامها.
| الحرف | الوصف |
|---|---|
| أي رمز عملة | علامة الدولار، علامة السنت، علامة اليورو، إلخ. |
| + | علامة الجمع |
| ( | قوس أيسر |
| : | علامة النقطتين |
| ^ | علامة الإدخال (علامة الإقحام) |
| ' | فاصلة |
| { | قوس متعرج أيسر |
| < | علامة أقل من |
| = | علامة تساوي |
| - | علامة ناقص |
| / | علامة الشرطة المائلة |
| ) | قوس أيمن |
| & | علامة العطف |
| ~ | التلدة |
| } | قوس متعرج أيمن |
| > | علامة أكبر من |
| حرف مسافة |
تطبيقات عمومية
وظيفة Text متوافقة بشكل عام. بالنسبة لمجموعة واسعة من اللغات ، فإنه يعرف كيفية كتابة التواريخ والأوقات والعملات والأرقام بشكل صحيح. للقيام بعملها ، فإنها تحتاج إلى معلومتين:
- لغة التنسيق المخصص: بالنسبة للصانعين، كيف يجب تفسير التنسيق المخصص؟ الحرفان الفاصلان (. و,) لديهما معانٍ مختلفة بلغات مختلفة. إذا حددت تنسيقًا مخصصًا ، فيمكنك تضمين عنصر نائب للغة أو أخذ القيمة الافتراضية ، والتي تعكس اللغة التي تم تعيين جهازك عليها. بشكل أسهل، يمكنك استخدام أحد تنسيقات التاريخ/الوقت المحددة سابقًا، التي تكون خاصة باللغة.
- لغة النتيجة: بالنسبة للمستخدمين، بأي لغة ينبغي ان تظهر نتيجة الوظيفة؟ يجب أن تكون أسماء الأشهر وأيام الأسبوع باللغة المناسبة لمستخدم التطبيق ، والتي يمكنك تحديدها بإضافة وسيطة اختيارية ثالثة لوظيفة Text.
لكليهما ، يمكنك تحديد اللغة باستخدام علامة اللغة. للاطلاع على قائمة اللغات المدعومة، اكتب Text( 1234, "", ) في شريط الصيغة أو علامة التبويب الإعدادات المتقدمة في الجزء الأيمن، ثم قم بالتمرير عبر قائمة الإعدادات المحلية المقترحة للوسيطة الثالثة.
عنصر نائب للغة
لتحديد اللغة الخاصة بالتنسيق المخصص ، استخدم:
| عنصر نائب | الوصف |
|---|---|
| [$-LanguageTag] | LanguageTag هي علامة لغة تم إرجاعها من وظيف Language. يمكنها تحديد اللغة فقط (مثل [$-en] للغة الإنجليزية)، أو يمكنها أيضًا تحديد المنطقة (مثل [$-en-GB] لتحديد بريطانيا العظمى بشكل أكبر). |
يمكن أن يظهر العنصر النائب للغة في أي مكان بالتنسيق المخصص ولكن مرة واحدة فقط.
إذا حددت تنسيقًا مخصصًا بدون عنصر نائب للغة وكان التنسيق غامضًا من وجهة نظر عامة ، فسيتم إدراج علامة اللغة الخاصة بلغتك الحالية تلقائيًا.
[$-ar-sa] يتم افتراض إذا لم يكن هذا العنصر النائب موجودا عند تشغيل التطبيق الخاص بك.
ملاحظة
في إصدار مستقبلي ، قد تتغير بنية هذا العنصر النائب لتجنب الخلط بينه وبين عنصر نائب مماثل ، ولكن مختلف ، يدعمه Excel.
علامة لغة النتيجة
تشتمل نتيجة Text على سلاسل مترجمة للأشهر وأيام الأسبوع وتعيينات ص/م، بالإضافة إلى المجموعة المناسبة والفواصل العشرية.
وبشكل افتراضي، تستخدم وظيفة Text لغة المستخدم الذي يقوم بتشغيل التطبيق. تقوم وظيفة Language بإرجاع علامة اللغة للمستخدم الحالي. يمكنك تجاوز هذه القيمة الافتراضية من خلال توفير علامة لغة للوسيطة الثالثة إلى Text.
بناء الجملة
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - مطلوب. الرقم أو قيمه التاريخ/الوقت المراد تنسيقها.
- DateTimeFormat - مطلوب. عضو في تعداد DateTimeFormat.
- ResultLanguageTag - اختياري. علامة اللغة المراد استخدامها لنص النتيجة. بشكل افتراضي ، يتم استخدام لغة المستخدم الحالي.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- رقم - مطلوب. الرقم أو قيمه التاريخ/الوقت المراد تنسيقها.
- CustomFormat - مطلوب. واحد أو أكثر من العناصر النائبة محاطة بعلامات اقتباس مزدوجة.
- ResultLanguageTag - اختياري. علامة اللغة المراد استخدامها لنص النتيجة. بشكل افتراضي ، يتم استخدام لغة المستخدم الحالي.
Text( AnyValue )
- AnyValue - مطلوب. القيمة المطلوب تحويلها إلى تمثيل نصي. يتم استخدام أحد التنسيقات الافتراضية.
نص ( غير مصنف )
- غير مصنف - مطلوب. كائن غير مصنف يمثل سلسلة. تعتمد القيم المقبولة على الموفر غير المصنف. بالنسبة ل 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( Now(), DateTimeFormat.LongDate ) | التنسيقات كسلسلة تاريخية طويلة ، بلغة ولغة المستخدم الحالي. | "الإثنين، 23 نوفمبر، 2015" |
| Text( Now(), DateTimeFormat.LongDateTime ) | التنسيقات كسلسلة تاريخ ووقت طويلة ، بلغة ولغة المستخدم الحالي ، باستخدام ساعة 12 ساعة. | "الإثنين، 23 نوفمبر، 2015 2:37:47 م" |
| Text( Now(), DateTimeFormat.LongTime24 ) | التنسيقات كسلسلة زمنية طويلة ، باستخدام ساعة 24 ساعة. | "14:37:47" |
| Text( Now(), 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( Date(2016,1,31), "dddd mmmm d" ) | إرجاع أيام الأسبوع والشهر ويوم الشهر بلغة المستخدم الحالي. نظرًا لعدم اعتماد أي عنصر نائب على اللغة، فلا توجد حاجة إلى علامة لغة نص التنسيق. | "الأحد 31 يناير" |
| Text( Date(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( true ) | تحويل قيمة منطقية إلى سلسلة. | "صواب" |
| Text( GUID() ) | تحويل قيمة GUID تم إنشاؤها إلى سلسلة. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | إرجاع الأحرف الأربعة الأولى من GUID الذي تم إنشاؤه. | "2d9c" |