הפונקציה Text

חל על: יישומי בד ציור Canvas apps Dataverse עמודות נוסחה יישומים מונחי-דגמים Power Platform CLI

ממירה כל ערך ומעצבת מספר או ערך תאריך/שעה למחרוזת טקסט.

תיאור

הפונקציה Text מעצבת מספר או ערך תאריך/שעה בהתבסס על אחד מסוגי הארגומנטים הללו:

• תבנית תאריך/שעה מוגדרת מראש, שאתה מציין באמצעות הספירה DateTimeFormat. עבור תאריכים ושעות, גישה זו עדיפה משום שהיא מתאימה את עצמה באופן אוטומטי לכל שפה ואזור של משתמש.
• תבנית מותאמת אישית, המורכבת ממחרוזת של מצייני מיקום אשר מגדירים, לדוגמה, אם מספרים מציגים מפריד עשרוני ותאריכים מציגים את השם המלא של החודש, את החודש כקיצור או את החודש כמספר. Power Apps תומך בקבוצת המשנה של מצייני המיקום ש- Microsoft Excel עושה. במחרוזת זו, מציין המיקום של השפה מציין את השפה שבה יש לפרש את מצייני המיקום האחרים. אם התבנית המותאמת אישית כוללת נקודה, לדוגמה, מציין המיקום של תבנית השפה מציין אם הנקודה היא מפריד עשרוני (ja-JP) או מפריד אלפיים (es-ES).

ראה עבודה עם תאריכים ושעות לקבלת מידע נוסף.

הפונקציה Text יכולה גם להמיר כל סוג נתונים לייצוג של טקסט באמצעות תבנית ברירת מחדל. השתמש באפשרות זו כדי להעביר ערכים שאינם טקסט לפונקציות מבוססות-טקסט כגון Len, Right, ו- IsMatch.

תבניות תאריך/שעה מוגדרות מראש

עבור דוגמאות אלה, התאריך והשעה משמשים ביום שלישי, 7 באפריל, 2020‎‏ 8:26:59.18‎0 PM באזור הזמן UTC-7 שעות.

DateTimeFormat enum	תיאור	דוגמאות (באמצעות en-US)
תאריך ארוך	שנה בת ארבע ספרות, שם חודש, יום בחודש ויום בשבוע. שמות החודש והיום בשבוע אינם מקוצרים.	"יום שלישי, 7 באפריל, 2020"
LongDateTime	שנה בת ארבע ספרות, שם חודש, יום בחודש ויום בשבוע, בנוסף לשעה (שעון של 12 שעות), דקות, שניות והקצאה של AM/PM. שמות החודש והיום בשבוע אינם מקוצרים.	"יום שלישי, 7 באפריל, 2020 8:26:5‎9 PM"
LongDateTime24	שנה בת ארבע ספרות, חודש, יום בחודש ויום בשבוע, בנוסף לשעה (שעון של 24 שעות), דקות ושניות. שמות החודש והיום בשבוע אינם מקוצרים.	"יום שלישי, 7 באפריל, 2020 20:26:59"
LongTime	שעה (שעון של 12 שעות), דקות, שניות והקצאה של AM/PM.	"8:26:5‎9 PM"
LongTime24	שעה (שעון של 24 שעות), דקות, שניות.	"20:26:59"
תאריך קצר	שנה בת ארבע ספרות עם חודש מספרי ויום בחודש.	"7/4/2020"
ShortDateTime	שנה בת ארבע ספרות עם חודש מספרי ויום בחודש, בנוסף לשעה (שעון של 12 שעות), דקות והקצאה של AM/PM.	"7/4/2020 8:2‎6 PM"
ShortDateTime24	שנה בת ארבע ספרות עם חודש מספרי ויום בחודש, בנוסף לשעה (שעון של 24 שעות) ודקות.	"7/4/2020 20:26"
ShortTime	שעה (שעון של 12 שעות), דקות והקצאה של AM/PM.	"8:2‎6 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	מציג את החודש כשם מלא (ינואר עד דצמבר).
י	מציג את היום כמספר ללא אפס מוביל.
dd	מציג את היום כמספר עם אפס מוביל כאשר מתאים.
ddd	מציג את היום כקיצור (א עד ש).
dddd	מציג את היום כשם מלא (יום ראשון עד יום שבת).
yy	מציג את השנה כמספר דו-ספרתי.
yyyy	מציג את השנה כמספר בעל ארבע ספרות.
שע	מציג את השעה כמספר ללא אפס מוביל.
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]	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 ] )

• Number - נדרש. המספר או ערך התאריך/שעה לעיצוב.
• CustomFormat - נדרש. מציין מיקום אחד או יותר המוקף במרכאות כפולות.
• ResultLanguageTag - אופציונלי. תגית השפה שתשמש עבור טקסט התוצאה. כברירת מחדל, השפה של המשתמש הנוכחי נמצאת בשימוש.

Text( AnyValue )

• AnyValue - נדרש. ערך להמרה לייצוג טקסט. נעשה שימוש בתבנית ברירת מחדל.

טקסט ( לא מסווג )

• Untyped - נדרש. אובייקט לא מסווג שמייצג מחרוזת. ערכים מקובלים תלויים בספק הלא מסווג. עבור 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:4‎7 PM"
Text( Now(), DateTimeFormat.LongTime24 )	מעצב כמחרוזת שעה ארוכה, באמצעות שעון של 24 שעות.	"14:37:47"
Text( Now(), DateTimeFormat.ShortDate )	מעצב כמחרוזת תאריך קצרה, בשפה ובאזור של המשתמש הנוכחי.	"23/11/2015"
Text( Now(), "d-mmm-yy" )	מעצב באמצעות תווי מציין מיקום: d עבור יום חד-ספרתי או דו-ספרתי של החודש - כתו ליטרל שהועתק לתוצאה mmm עבור קיצור בן שלוש אותיות של החודש - כתו ליטרל אחר שהועתק לתוצאה yy עבור קיצור דו-ספרתי של השנה	"23-נובמבר-15"
Text(1448318857*1000, "mmm. ‎dd, yyyy (hh:mm:ss AM/PM)")‎	מציג ערך תאריך-שעה של Unix בתבנית הניתנת לקריאה על-ידי אדם אם אתה מכפיל את ערך המקור ב- 1,000.	"23 בנובמבר, 2015 (02:47:3‎7 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".	"domingo enero 31"

המרת ערכים לטקסט

נוסחה	תיאור	תוצאה
Text( 1234567.89 )	ממיר מספר למחרוזת. אין מפרידי אלפים או שליטה במספר הספרות לפני או אחרי המפריד העשרוני; לקבלת שליטה רבה יותר, ספק מצייני מיקום של מספרים כארגומנט השני.	"1234567.89"
Text( DateTimeValue( "01/04/2003" ) )	ממיר ערך תאריך/שעה למחרוזת טקסט. כדי לשלוט בהמרה, ציין חבר בספירת DateTimeFormat או מחרוזת בעלת תבנית מותאמת אישית.	"4/1/2003 12:0‎0 AM"
Text( true )	ממיר ערך בוליאני למחרוזת.	"true"
Text( GUID() )	ממיר ערך GUID שנוצר למחרוזת.	"f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Left( Text( GUID() ), 4 )	מחזיר את ארבעת התווים הראשונים של GUID שנוצר.	"2d9c"