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