पाठ फ़ंक्शन
इस पर लागू होता है:
कैनवास ऐप्स कैनवास ऐप्स Dataverse सूत्र स्तंभ मॉडल-संचालित ऐप्स Power Pages Power Platform CLI
मान को रूपांतरित करता है और संख्या या दिनांक/समय मान को पाठ के स्ट्रिंग में स्वरूपित करता है.
वर्णन
Text फ़ंक्शन निम्न में से किसी एक प्रकार के तर्क के आधार पर संख्या या दिनांक/समय मान को स्वरूपित करता है:
- एक पूर्वनिर्धारित दिनांक/समय स्वरूप, जिसे आप DateTimeFormat प्रगणना का उपयोग करके निर्दिष्ट करते हैं. दिनांक और समय के लिए, यह दृष्टिकोण पसंदीदा है, क्योंकि यह स्वचालित रूप से प्रत्येक उपयोगकर्ता की भाषा और क्षेत्र में समायोजित हो जाता है.
- उदाहरण के लिए एक कस्टम स्वरूप, जिसमें प्लेसहोल्डर्स की एक स्ट्रिंग शामिल होती है, जो परिभाषित करती है कि संख्याएँ एक दशमलव विभाजक दिखाए या नहीं और दिनांक महीने का पूरा नाम, महीने का संक्षिप्त नाम या महीने को संख्या के रूप में दिखाए या नहीं. Power Apps उन प्लेसहोल्डर्स के एक सबसेट का समर्थन करता है, जिनका Microsoft Excel करता है. इस स्ट्रिंग में, भाषा प्लेसहोल्डर उस भाषा को निर्दिष्ट करता है, जिसमें अन्य प्लेसहोल्डर की व्याख्या करनी है. उदाहरण के लिए, यदि कस्टम स्वरूप में एक पीरियड शामिल है, तो भाषा-स्वरूप प्लेसहोल्डर निर्दिष्ट करता है कि पीरियड एक दशमलव विभाजक (ja-JP) या एक हजार विभाजक (es-ES) है.
अधिक जानकारी के लिए दिनांक और समय के साथ कार्य करना देखें.
Text फ़ंक्शन डिफ़ॉल्ट स्वरूप का उपयोग करके किसी भी डेटा प्रकार को पाठ प्रस्तुति में भी बदल सकता है. इसका उपयोग गैर-पाठ मानों को पाठ-आधारित फ़ंक्शन में पास करने के लिए करें, जैसे Len, Right और IsMatch.
पूर्वनिर्धारित दिनांक/समय स्वरूप
इन उदाहरणों के लिए, समय क्षेत्र UTC-7 घंटे में, उपयोग किया गया दिनांक और समय मंगलवार, 7 अप्रैल, 2020 8:26:59.180 अपराह्न है.
| DateTimeFormat इनम | वर्णन | उदाहरण (en-US का उपयोग करना) |
|---|---|---|
| लाँगडेट | चार अंकों का वर्ष, महीने का नाम, महीने का दिन और सप्ताह का दिन. महीने और सप्ताह के दिनों के नाम संक्षिप्त नहीं किए जाते हैं. | "Tuesday, April 7, 2020" |
| लंबी तिथिसमय | चार अंकों का वर्ष, महीने का नाम, महीने का दिन और सप्ताह का दिन, साथ ही घंटे (12 घंटे की घड़ी), मिनट, सेकंड और पूर्वाह्न/अपराह्न डेज़िग्नेशन. महीने और सप्ताह के दिनों के नाम संक्षिप्त नहीं किए जाते हैं. | "Tuesday, April 7, 2020 8:26:59 PM" |
| लंबीदिनांकसमय24 | चार अंकों का वर्ष, महीने का नाम, महीने का दिन और सप्ताह का दिन, साथ ही घंटे (24 घंटे की घड़ी), मिनट और सेकंड. महीने और सप्ताह के दिनों के नाम संक्षिप्त नहीं किए जाते हैं. | "Tuesday, April 7, 2020 20:26:59" |
| लंबे समय तक | घंटे (12 घंटे की घड़ी), मिनट, सेकंड और पूर्वाह्न/अपराह्न डेज़िग्नेशन. | "8:26:59 PM" |
| लॉन्गटाइम24 | घंटे (24 घंटे की घड़ी), मिनट, सेकंड. | "20:26:59" |
| कम समय | संख्यात्मक महीने और महीने के दिन के साथ चार अंकों का वर्ष. | "4/7/2020" |
| लघुदिनांकसमय | संख्यात्मक महीने और महीने के दिन के साथ चार अंकों का वर्ष, साथ ही घंटे (12 घंटे की घड़ी), मिनट और पूर्वाह्न/अपराह्न डेज़िग्नेशन. | "4/7/2020 8:26 PM" |
| लघुदिनांकसमय24 | संख्यात्मक महीने और महीने के दिन के साथ चार अंकों का वर्ष, साथ ही घंटे (24 घंटे की घड़ी) और मिनट. | "4/7/2020 20:26" |
| लघुसमय | घंटे (12 घंटे की घड़ी), मिनट और पूर्वाह्न/अपराह्न डेज़िग्नेशन. | "8:26 PM" |
| शॉर्टटाइम24 | घंटे (24 घंटे की घड़ी) और मिनट. | "20:26" |
| UTC | वर्तमान उपयोगकर्ता के समय क्षेत्र के आधार पर दिनांक/समय को UTC में रूपांतरित किया जाता है और ISO 8601 मानक के अनुसार स्वरूपित किया जाता है. | "2020-04-08T03:26:59.180Z" |
संख्या प्लेसहोल्डर
| प्लेसहोल्डर | वर्णन |
|---|---|
| 0 (शून्य) | यदि स्वरूप में मौजूद शून्यों की तुलना में संख्या में कम अंक हैं, तो निरर्थक शून्य प्रदर्शित करता है. यदि आप 8.9 को 8.90 के रूप में प्रदर्शित करना चाहते हैं, तो स्वरूप #.00 का उपयोग करें. |
| # | 0 (शून्य) की तरह समान नियमों का पालन करता है. यदि स्वरूप में # चिह्नों की तुलना में, संख्या में दशमलव के दोनों ओर कम अंक होते हैं, तो Text अतिरिक्त शून्य नहीं दिखाता है. उदाहरण के लिए, यदि कस्टम स्वरूप #.## है और स्वरूपित की जाने वाली संख्या 8.9 है, तो 8.9 प्रदर्शित किया जाता है. |
| . (पीरियड) | संख्या में दशमलव बिंदु प्रदर्शित करता है. कस्टम स्वरूप की भाषा पर निर्भर करता है; अधिक जानकारी के लिए, ग्लोबल ऐप्स देखें. |
| , (अल्पविराम) | संख्या में समूहीकरण विभाजक प्रदर्शित करता है, जिसका उपयोग अक्सर हजार के लिए किया जाता है. यदि प्रारूप में अल्पविराम है जो संख्या चिह्नों ( ) या शून्यों से घिरा है, तो Text#समूहों को अल्पविरामों द्वारा अलग करता है। कस्टम स्वरूप की भाषा पर निर्भर करता है; अधिक जानकारी के लिए, ग्लोबल ऐप्स देखें. |
यदि किसी स्वरूप में प्लेसहोल्डर की तुलना में संख्या में दशमलव बिंदु के दाईं ओर अधिक अंक हैं, तो संख्या उतने दशमलव स्थानों तक पूर्णांक हो जाएगी, जितने प्लेसहोल्डर हैं. यदि दशमलव बिंदु के बाईं ओर प्लेसहोल्डर की तुलना में अधिक अंक हैं, तो अतिरिक्त अंक प्रदर्शित होते हैं. यदि स्वरूप में दशमलव बिंदु के बाईं ओर केवल संख्या चिह्न (#) हैं, तो 1 से छोटी संख्या दशमलव बिंदु से शुरू होती है (उदाहरण के लिए, .47).
दिनांक और समय प्लेसहोल्डर
| प्लेसहोल्डर | वर्णन |
|---|---|
| एम | महीने को अग्रणी शून्य के बिना संख्या के रूप में प्रदर्शित करता है. |
| मिमी | उपयुक्त होने पर महीने को अग्रणी शून्य के साथ संख्या के रूप में प्रदर्शित करता है. |
| मम्म | महीने को संक्षिप्त नाम से प्रदर्शित करता है (Jan से लेकर Dec तक). |
| मम्म्म्म | महीने को पूरे नाम से प्रदर्शित करता है (January से लेकर December तक). |
| डी | दिन को अग्रणी शून्य के बिना संख्या के रूप में प्रदर्शित करता है. |
| डीडी | उपयुक्त होने पर दिन को अग्रणी शून्य के साथ संख्या के रूप में प्रदर्शित करता है. |
| डीडीडी | दिन को संक्षिप्त नाम से प्रदर्शित करता है (Sun से लेकर Sat तक). |
| dddd | दिन को पूरे नाम से प्रदर्शित करता है (Sunday से लेकर Saturday तक). |
| वर्ष | वर्ष को दो अंकों की संख्या के रूप में प्रदर्शित करता है. |
| वर्ष | वर्ष को चार अंकों की संख्या के रूप में प्रदर्शित करता है. |
| एच | घंटे को अग्रणी शून्य के बिना संख्या के रूप में प्रदर्शित करता है. |
| एचएच | उपयुक्त होने पर घंटे को अग्रणी शून्य के साथ संख्या के रूप में प्रदर्शित करता है. यदि स्वरूप में AM या PM है, तो घंटे को 12 घंटे की घड़ी के आधार पर प्रदर्शित किया जाता है. अन्यथा, घंटे को 24-घंटे की घड़ी के आधार पर प्रदर्शित किया जाता है. |
| एम | मिनट को अग्रणी शून्य के बिना संख्या के रूप में प्रदर्शित करता है. इस प्लेसहोल्डर को h या hh कोड के तुरंत बाद दिखाई देना चाहिए या ss कोड से तुरंत पहले; अन्यथा, Text मिनट के बजाय महीना दिखाता है. |
| मिमी | उपयुक्त होने पर मिनट को अग्रणी शून्य के साथ संख्या के रूप में प्रदर्शित करता है. इस प्लेसहोल्डर को h या hh प्लेसहोल्डर के तुरंत बाद दिखाई देना चाहिए या ss प्लेसहोल्डर से तुरंत पहले. अन्यथा, Text मिनट के बजाय महीना दिखाता है. |
| एस | सेकंड को अग्रणी शून्य के बिना संख्या के रूप में प्रदर्शित करता है. |
| एस एस | उपयुक्त होने पर सेकंड को अग्रणी शून्य के साथ संख्या के रूप में प्रदर्शित करता है. |
| एफ | सेकंड के भाग को प्रदर्शित करता है. |
| AM/PM, a/p | 12-घंटे की घड़ी के आधार पर घंटे को प्रदर्शित करता है. Text आधी रात से दोपहर तक के समय के लिए "AM" या "a" लौटाता है और दोपहर से आधी रात तक के समय के लिए "PM" या "p" लौटाता है |
लिटरल प्लेसहोल्डर
आप अपने स्वरूप स्ट्रिंग में इनमें से किसी भी वर्ण को शामिल कर सकते हैं. वे Text के परिणाम में जैसे हैं वैसे ही दिखाई देंगे. अतिरिक्त वर्ण भविष्य के प्लेसहोल्डर के लिए आरक्षित हैं, इसलिए आपको उनका उपयोग नहीं करना चाहिए.
| वर्ण | वर्णन |
|---|---|
| कोई भी मुद्रा चिह्न | डॉलर चिन्ह, सेंट चिन्ह, यूरो चिन्ह, आदि. |
| + | प्लस चिन्ह |
| ( | बायाँ कोष्ठक |
| : | पूर्णविराम |
| ^ | Circumflex एक्सेंट (कैरेट) |
| ' | अपॉस्ट्रॉफ़ी |
| { | बायाँ कर्ली कोष्ठक |
| < | इससे-कम चिह्न |
| = | बराबर चिह्न |
| - | ऋण चिह्न |
| / | स्लैश चिह्न |
| ) | दायाँ कोष्ठक |
| & | ऐंपरसैंड |
| ~ | लहरिल डैश |
| } | दायाँ कर्ली कोष्ठक |
| > | इससे-बड़ा चिह्न |
| रिक्ति वर्ण |
ग्लोबल ऐप्स
Text फ़ंक्शन से ग्लोबल रूप से परिचित हैं. भाषाओं की एक विस्तृत सरणी के लिए, यह जानता है कि दिनांक, समय, मुद्राओं और संख्याओं को ठीक से कैसे लिखा जाए. अपना कार्य करने के लिए, इसे दो जानकारी चाहिए:
- कस्टम प्रारूप की भाषा: निर्माताओं के लिए, कस्टम प्रारूप की व्याख्या कैसे की जानी चाहिए? विभाजक वर्ण (. और ,) अलग-अलग भाषाओं में अलग-अलग अर्थ रखते हैं। यदि आप एक कस्टम स्वरूप निर्दिष्ट करते हैं, तो आप एक भाषा प्लेसहोल्डर को शामिल कर सकते हैं या डिफ़ॉल्ट मान ले सकते हैं, जो उस भाषा को दर्शाता है, जिस पर आपका डिवाइस सेट है. और भी आसानी के लिए, आप पूर्वनिर्धारित दिनांक/समय स्वरूप का उपयोग कर सकते हैं, जो भाषा अग्नॉस्टिक होते हैं.
- परिणाम की भाषा: उपयोगकर्ताओं के लिए, फ़ंक्शन परिणाम किस भाषा में दिखाई देना चाहिए? ऐप के उपयोगकर्ता के लिए, महीनों और कार्य दिवस के नाम उपयुक्त भाषा में होने चाहिए, जिन्हें आप Text फ़ंक्शन में एक तीसरा, वैकल्पिक तर्क जोड़ कर निर्दिष्ट कर सकते हैं.
दोनों के लिए, आप भाषा को भाषा टैग का उपयोग करके निर्दिष्ट करते हैं. समर्थित भाषाओं की सूची देखने के लिए, सूत्र पट्टी में या दाईं ओर के फलक में उन्नत टैब में Text( 1234, "", ) लिखें और उसके बाद तीसरे तर्क के लिए सुझाए गए लोकेल की सूची में स्क्रॉल करें.
भाषा प्लेसहोल्डर
कस्टम स्वरूप की भाषा निर्दिष्ट करने के लिए, निम्न का उपयोग करें:
| प्लेसहोल्डर | वर्णन |
|---|---|
| [$-भाषा टैग] | LanguageTag एक भाषा टैग है जो Language फ़ंक्शन से लौटाया जाता है। यह सिर्फ भाषा (जैसे कि अंग्रेज़ी के लिए [$-en]) निर्दिष्ट कर सकता है या यह क्षेत्र (जैसे कि ग्रेट ब्रिटेन को आगे निर्दिष्ट करने के लिए [$-en-GB]) भी निर्दिष्ट कर सकता है. |
भाषा प्लेसहोल्डर, कस्टम स्वरूप में कहीं भी दिखाई दे सकता है, लेकिन केवल एक बार.
यदि आप भाषा प्लेसहोल्डर के बिना कस्टम स्वरूप निर्दिष्ट करते हैं और स्वरूप ग्लोबल दृष्टिकोण से अस्पष्ट होता है, तो आपकी वर्तमान भाषा के लिए भाषा टैग स्वचालित रूप से सम्मिलित हो जाता है.
[$-en-US] यह मान लिया जाता है यदि आपका ऐप चलाते समय यह प्लेसहोल्डर मौजूद नहीं है.
नोट
भविष्य के संस्करण में, इस प्लेसहोल्डर का सिंटैक्स, समान, लेकिन भिन्न उस प्लेसहोल्डर के साथ भ्रम को दूर करने के लिए बदल सकता है, जिसका Excel समर्थन करता है.
परिणाम भाषा टैग
Text के परिणाम में महीनों, कार्य दिवस और पूर्वाह्न/अपराह्न डेज़िग्नेशन के अनुवादित स्ट्रिंग के साथ-साथ उपयुक्त समूह और दशमलव विभाजक शामिल होते हैं.
डिफ़ॉल्ट रूप से, Text, ऐप चलाने वाले उपयोगकर्ता की भाषा का उपयोग करता है. Language फ़ंक्शन वर्तमान उपयोगकर्ता के लिए भाषा टैग दिखाता है. तीसरे तर्क के लिए, आप Text को भाषा टैग प्रदान करके इस डिफ़ॉल्ट मान को ओवरराइड कर सकते हैं.
सिंटैक्स
टेक्स्ट( संख्या या दिनांक समय, दिनांक समय प्रारूप गणना [, परिणाम भाषा टैग ] )
- NumberOrDateTime - आवश्यक. स्वरूपित की जाने वाली संख्या या दिनांक/समय मान.
- DateTimeFormat - आवश्यक. DateTimeFormat प्रगणना का सदस्य.
- ResultLanguageTag - वैकल्पिक. परिणाम पाठ के लिए उपयोग किया जाने वाला भाषा टैग. डिफ़ॉल्ट रूप से, वर्तमान उपयोगकर्ता की भाषा का उपयोग किया जाता है.
टेक्स्ट( नंबर या दिनांक समय, कस्टम प्रारूप [, परिणाम भाषा टैग ] )
- संख्या - आवश्यक. स्वरूपित की जाने वाली संख्या या दिनांक/समय मान.
- CustomFormat - आवश्यक. दोहरे उद्धरण चिह्नों के अंदर एक या अधिक प्लेसहोल्डर.
- ResultLanguageTag - वैकल्पिक. परिणाम पाठ के लिए उपयोग किया जाने वाला भाषा टैग. डिफ़ॉल्ट रूप से, वर्तमान उपयोगकर्ता की भाषा का उपयोग किया जाता है.
टेक्स्ट( AnyValue )
- AnyValue - आवश्यक. पाठ प्रस्तुति में रूपांतरित किए जाने वाला मान. डिफ़ॉल्ट स्वरूप का उपयोग किया जाता है.
पाठ ( अलिखित )
- अलिखित - आवश्यक. अनटाइप्ड ऑब्जेक्ट जो एक स्ट्रिंग का प्रतिनिधित्व करता है। स्वीकार्य मान अनटाइप्ड प्रदाता पर निर्भर हैं। 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-Nov-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | यदि आप स्रोत मान को 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 €" |
| पाठ( Date(2016,1,31), "dddd mmmm d" ) | सप्ताह के दिन, महीने और कार्यदिवस को वर्तमान उपयोगकर्ता की भाषा में दिखाता है. क्योंकि कोई भी प्लेसहोल्डर भाषा पर निर्भर नहीं है, इसलिए स्वरूप पाठ भाषा टैग की कोई आवश्यकता नहीं है. | "रविवार जनवरी 31" |
| टेक्स्ट (Date(2016,1,31), "dddd mmmm d", "es-ES") | सप्ताह के दिन, महीने और कार्यदिवस को "es-ES" भाषा में दिखाता है. | "domingo enero31" |
मान को पाठ में रूपांतरित करना
| सूत्र | वर्णन | परिणाम |
|---|---|---|
| पाठ( 1234567.89 ) | संख्या को स्ट्रिंग में रूपांतरित करता है. दशमलव विभाजक के पहले या बाद में अंकों की संख्या पर कोई हजार विभाजक या नियंत्रक नहीं है; अधिक नियंत्रण के लिए, दूसरे तर्क के रूप में नंबर प्लेसहोल्डर प्रदान करें. | "1234567.89" |
| पाठ( दिनांकसमयमान( "01/04/2003") ) | दिनांक/समय मान को पाठ के स्ट्रिंग में रूपांतरित करता है. रूपांतरण को नियंत्रित करने के लिए, या तो DateTimeFormat प्रगणना का सदस्य या कस्टम-स्वरूप स्ट्रिंग प्रदान करें. | "1/4/2003 12:00 पूर्वाह्न" |
| पाठ( सत्य ) | बूलियन मान को स्ट्रिंग में रूपांतरित करता है. | "सही" |
| पाठ( GUID() ) | जनरेट किए गए GUID मान को स्ट्रिंग में रूपांतरित करता है. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| बायाँ( पाठ( GUID() ), 4 ) | जनरेट किए गए GUID के पहले चार वर्ण दिखाता है. | "2d9c" |