הערה
גישה לעמוד זה דורשת אישור. אתה יכול לנסות להיכנס או לשנות תיקיות.
גישה לעמוד זה דורשת אישור. אתה יכול לנסות לשנות מדריכים.
חל על:
אפליקציות Canvas Studio Copilot Studio זורמות עמודות נוסחאות 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 שעות.
| Enum DateTimeFormat | תיאור | דוגמאות (באמצעות en-US) |
|---|---|---|
| LongDate | שנה בת ארבע ספרות, שם חודש, יום בחודש ויום בשבוע. שמות החודש והיום בשבוע אינם מקוצרים. | "יום שלישי, 7 באפריל, 2020" |
| LongDateTime | שנה בת ארבע ספרות, שם חודש, יום בחודש ויום בשבוע, בנוסף לשעה (שעון של 12 שעות), דקות, שניות והקצאה של AM/PM. שמות החודש והיום בשבוע אינם מקוצרים. | "יום שלישי, 7 באפריל, 2020 8:26:59 PM" |
| LongDateTime24 | שנה בת ארבע ספרות, חודש, יום בחודש ויום בשבוע, בנוסף לשעה (שעון של 24 שעות), דקות ושניות. שמות החודש והיום בשבוע אינם מקוצרים. | "יום שלישי, 7 באפריל, 2020 20:26:59" |
| זמן רב | שעה (שעון של 12 שעות), דקות, שניות והקצאה של AM/PM. | "8:26:59 PM" |
| LongTime24 | שעה (שעון של 24 שעות), דקות, שניות. | "20:26:59" |
| ShortDate | שנה בת ארבע ספרות עם חודש מספרי ויום בחודש. | "7/4/2020" |
| ShortDateTime | שנה בת ארבע ספרות עם חודש מספרי ויום בחודש, בנוסף לשעה (שעון של 12 שעות), דקות והקצאה של AM/PM. | "7/4/2020 8:26 PM" |
| ShortDateTime24 | שנה בת ארבע ספרות עם חודש מספרי ויום בחודש, בנוסף לשעה (שעון של 24 שעות) ודקות. | "7/4/2020 20:26" |
| ShortTime | שעה (שעון של 12 שעות), דקות והקצאה של AM/PM. | "8:26 PM" |
| 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 או FM, השעה מוצגת בהתבסס על השעון בן 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 הוא תג שפה המוחזר מהפונקציה 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(דינמי) אני לא יכול לעשות את זה.
- Dynamic - נדרש. ערך דינאמי המייצג מחרוזת. ערכים מקובלים תלויים בספק הלא מסווג. עבור 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 PM ביום שני, 23 בנובמבר, 2015
- אזור זמן של ארצות הברית והאוקיינוס השקט (UTC-8)
| נוסחה | תיאור | תוצאה |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | מעצב כמחרוזת תאריך ארוכה, בשפה ובאזור של המשתמש הנוכחי. | "יום שני, 23 בנובמבר, 2015" |
| Text( Now(), DateTimeFormat.LongDateTime ) | מעצב כמחרוזת תאריך ושעה ארוכה, בשפה ובאזור של המשתמש הנוכחי, באמצעות שעון של 12 שעות. | "יום שני, 23 בנובמבר, 2015 2:37:47 PM" |
| Text( Now(), DateTimeFormat.LongTime24 ) | מעצב כמחרוזת שעה ארוכה, באמצעות שעון של 24 שעות. | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | מעצב כמחרוזת תאריך קצרה, בשפה ובאזור של המשתמש הנוכחי. | "23/11/2015" |
| Text( Now(), "d-mmm-yy" ) | מעצב באמצעות תווי מציין מיקום:
|
"23-נובמבר-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | מציג ערך תאריך-שעה של Unix בתבנית הניתנת לקריאה על-ידי אדם אם אתה מכפיל את ערך המקור ב- 1,000. | "23 בנובמבר, 2015 (02:47:37 PM)" |
יישומים כלליים
| נוסחה | תיאור | תוצאה |
|---|---|---|
| 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". | "אירוח מעולה" |
המרת ערכים לטקסט
| נוסחה | תיאור | תוצאה |
|---|---|---|
| Text( 1234567.89 ) | ממיר מספר למחרוזת. אין מפרידי אלפים או שליטה במספר הספרות לפני או אחרי המפריד העשרוני; לקבלת שליטה רבה יותר, ספק מצייני מיקום של מספרים כארגומנט השני. | "1234567.89" |
| Text( DateTimeValue( "04/01/2003" ) | ממיר ערך תאריך/שעה למחרוזת טקסט. כדי לשלוט בהמרה, ציין חבר בספירת DateTimeFormat או מחרוזת בעלת תבנית מותאמת אישית. | "4/1/2003 12:00 AM" |
| Text(true) אתה לא יכול לעשות את זה. | ממיר ערך בוליאני למחרוזת. | "true" |
| Text( GUID() ) | ממיר ערך GUID שנוצר למחרוזת. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | מחזיר את ארבעת התווים הראשונים של GUID שנוצר. | "2d9c" |