Funzione Text in PowerAppsText function in PowerApps

Formatta un valore numerico o di tipo data/ora per visualizzarlo come stringa di testo.Formats a number or a date/time value for display as a string of text.

DescrizioneDescription

La funzione Text formatta un valore numerico o di tipo data/ora sulla base di uno dei tipi di argomento seguenti:The Text function formats a number or a date/time value based on one of these types of arguments:

  • Un formato data/ora predefinito specificato mediante l'uso dell'enumerazione DateTimeFormat.A predefined date/time format, which you specify by using the DateTimeFormat enumeration. Per le date e le ore, questo approccio è preferibile in quanto adatta automaticamente il valore alla lingua e alla posizione geografica dell'utente.For dates and times, this approach is preferred as it automatically adjusts to each user's language and location.
  • Un formato personalizzato, ovvero una stringa di testo che include segnaposto indicanti il modo in cui deve essere formattato il valore numerico o di tipo data/ora.A custom format, a string of text that comprises placeholders that describe how to format the number or the date/time value. I segnaposto definiscono il numero di cifre da visualizzare, l'eventuale necessità di usare i separatori di raggruppamento e la modalità di visualizzazione dei nomi dei mesi.Placeholders define how many digits to show, whether grouping separators should be used, and how to display the name of a month. PowerApps supporta un subset di segnaposto supportati anche in Microsoft Excel.PowerApps supports a subset of the placeholders that Microsoft Excel does.

Per altre informazioni, vedere Working with dates and times (Utilizzo di date e ore).See working with dates and times for more information.

Formati data/ora predefinitiPredefined date/time formats

Formato predefinitoPredefined Format DescrizioneDescription
DateTimeFormat.LongDateDateTimeFormat.LongDate Anno completo, mese, giorno del mese e giorno della settimana.Full year, month, day of the month, and day of the week. I nomi del mese e del giorno della settimana non sono abbreviati.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongDateTimeDateTimeFormat.LongDateTime Anno completo, mese, giorno del mese e giorno della settimana più ora (formato a 12 ore), minuti, secondi e indicazione AM/PM.Full year, month, day of the month, and day of the week, plus hour (12-hour clock), minutes, seconds, and AM/PM designation. I nomi del mese e del giorno della settimana non sono abbreviati.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongDateTime24DateTimeFormat.LongDateTime24 Anno completo, mese, giorno del mese e giorno della settimana più ora (formato a 24 ore), minuti e secondi.Full year, month, day of the month, and day of the week, plus hour (24-hour clock), minutes, and seconds. I nomi del mese e del giorno della settimana non sono abbreviati.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongTimeDateTimeFormat.LongTime Ora (formato a 12 ore), minuti, secondi e indicazione AM/PM.Hour (12-hour clock), minutes, seconds, and AM/PM designation. Uguale a ShortTime.Same as ShortTime.
DateTimeFormat.LongTime24DateTimeFormat.LongTime24 Ora (formato a 24 ore), minuti e secondi.Hour (24-hour clock), minutes, seconds. Uguale a ShortTime24.Same as ShortTime24.
DateTimeFormat.ShortDateDateTimeFormat.ShortDate Anno in quattro cifre, mese e giorno del mese in due cifre.Four-digit year with two-digit month and day of the month.
DateTimeFormat.ShortDateTimeDateTimeFormat.ShortDateTime Anno in quattro cifre, mese e giorno del mese in due cifre, più ora (formato a 12 ore), minuti, secondi e indicazione AM/PM.Four-digit year with two-digit month and day of the month, plus hour (12-hour clock), minutes, seconds, and AM/PM designation.
DateTimeFormat.ShortDateTime24DateTimeFormat.ShortDateTime24 Anno in quattro cifre, mese e giorno del mese in due cifre, più ora (formato a 24 ore), minuti e secondi.Four-digit year with two-digit month and day of the month, plus hour (24-hour clock), minutes, and seconds.
DateTimeFormat.ShortTimeDateTimeFormat.ShortTime Ora (formato a 12 ore), minuti, secondi e indicazione AM/PM.Hour (12-hour clock), minutes, seconds, and AM/PM designation. Uguale a LongTime.Same as LongTime.
DateTimeFormat.ShortTime24DateTimeFormat.ShortTime24 Ora (formato a 24 ore), minuti e secondi.Hour (24-hour clock), minutes, and seconds. Uguale a LongTime24.Same as LongTime24.
DateTimeFormat.UTCDateTimeFormat.UTC Il valore di data/ora viene convertito nell'ora UTC in base al fuso orario dell'utente corrente e quindi formattato in base allo standard ISO 8601.The date/time value is converted to UTC based on the current user's time zone and formatted according to the ISO 8601 standard.

Segnaposto numericiNumber placeholders

SegnapostoPlaceholder DescrizioneDescription
0 (zero)0 (zero) Visualizza gli zeri non significativi se un numero ha meno cifre di quanti sono gli zeri nel formato.Displays insignificant zeros if a number has fewer digits than there are zeros in the format. Ad esempio, usare il formato #.00 per visualizzare 8.9 come 8.90.For example, use the format #.00 if you want to display 8.9 as 8.90.
# Segue le stesse regole di 0 (zero).Follows the same rules as the 0 (zero). La funzione Text, tuttavia, non restituisce zero aggiuntivi quando il numero ha meno cifre sulla parte opposta al decimale rispetto ai simboli # nel formato.However, Text doesn't return extra zeros when the number has fewer digits on either side of the decimal than there are # symbols in the format. Ad esempio, viene visualizzato 8.9 se il formato personalizzato è #.## e il numero da formattare è 8.9.For example, 8.9 is displayed if the custom format is #.## and the number to format is 8.9.
.. (punto)(period) Visualizza il separatore decimale in un numero.Displays the decimal point in a number. Dipende dalla lingua del formato personalizzato. Per altre informazioni dettagliate, vedere global apps (App globali).Depends on the language of the custom format, see global apps for more details.
, (virgola), (comma) Visualizza il separatore di raggruppamento in un numero ed è spesso usato per le migliaia.Displays the grouping separator in a number, often used for thousands. La funzione Text separa i gruppi mediante virgole se il formato contiene una virgola racchiusa tra simboli di cancelletto (#) o tra zeri.Text separates groups by commas if the format contains a comma that's enclosed by number signs (#) or by zeros. Dipende dalla lingua del formato personalizzato. Per altre informazioni dettagliate, vedere global apps (App globali).Depends on the language of the custom format, see global apps for more details.

Se un numero ha più cifre a destra del separatore decimale rispetto ai segnaposto del formato, il valore viene arrotondato a un numero di cifre decimali pari a quello dei segnaposto.If a number has more digits to the right of the decimal point than there are placeholders in the format, the number rounds to as many decimal places as there are placeholders. Se a sinistra del separatore decimale è presente un numero di cifre superiore a quello dei segnaposto, le cifre eccedenti vengono visualizzate.If there are more digits to the left of the decimal point than there are placeholders, the extra digits are displayed. Se il formato prevede solo simboli di cancelletto (#) a sinistra del separatore decimale, i numeri minori di 1 iniziano con un separatore decimale, ad esempio .47).If the format contains only number signs (#) to the left of the decimal point, numbers less than 1 start with a decimal point (for example, .47).

Segnaposto di data e oraDate and time placeholders

SegnapostoPlaceholder DescrizioneDescription
mm Visualizza il mese sotto forma di numero senza zero iniziale.Displays the month as a number without a leading zero.
mmmm Visualizza il mese sotto forma di numero con uno zero iniziale quando appropriato.Displays the month as a number with a leading zero when appropriate.
mmmmmm Visualizza l'abbreviazione del mese (da Gen a Dic).Displays the month as an abbreviation (Jan to Dec).
mmmmmmmm Visualizza il nome completo del mese (da Gennaio a Dicembre).Displays the month as a full name (January to December).
dd Visualizza il giorno sotto forma di numero senza zero iniziale.Displays the day as a number without a leading zero.
dddd Visualizza il giorno sotto forma di numero con uno zero iniziale quando appropriato.Displays the day as a number with a leading zero when appropriate.
dddddd Visualizza l'abbreviazione del giorno (da Dom a Sab).Displays the day as an abbreviation (Sun to Sat).
dddddddd Visualizza il nome completo del giorno (da Domenica a Sabato).Displays the day as a full name (Sunday to Saturday).
yyyy Visualizza l'anno come numero di due cifre.Displays the year as a two-digit number.
yyyyyyyy Visualizza l'anno come numero di quattro cifre.Displays the year as a four-digit number.
hh Visualizza l'ora sotto forma di numero senza zero iniziale.Displays the hour as a number without a leading zero.
hhhh Visualizza il giorno sotto forma di numero con uno zero iniziale quando appropriato.Displays the hour as a number with a leading zero when appropriate. Se il formato contiene AM o PM, l'ora viene visualizzata in base al formato a 12 ore.If the format contains AM or PM, the hour is shown based on the 12-hour clock. In caso contrario, l'ora viene visualizzata in base al formato a 24 ore.Otherwise, the hour is shown based on the 24-hour clock.
mm Visualizza il minuto sotto forma di numero senza zero iniziale.Displays the minute as a number without a leading zero. > [!NOTE]
> Il codice m o mm deve comparire immediatamente dopo il codice h o hh oppure immediatamente prima del codice ss. In caso contrario, la funzione Text restituisce il mese anziché i minuti.> The m or the mm code must appear immediately after the h or hh code or immediately before the ss code; otherwise, Text returns the month instead of minutes.
mmmm Visualizza il minuto sotto forma di numero con uno zero iniziale quando appropriato.Displays the minute as a number with a leading zero when appropriate. > [!NOTE]
Il segnaposto m o mm deve comparire immediatamente dopo il segnaposto h o hh oppure immediatamente prima del segnaposto ss.> The m or the mm placeholder must appear immediately after the h or hh placeholder or immediately before the ss placeholder. In caso contrario, la funzione Text restituisce il mese anziché i minuti.Otherwise, Text returns the month instead of minutes.
ss Visualizza il secondo sotto forma di numero senza zero iniziale.Displays the second as a number without a leading zero.
ssss Visualizza il secondo sotto forma di numero con uno zero iniziale quando appropriato.Displays the second as a number with a leading zero when appropriate.
ff Visualizza le frazioni di secondo.Displays the fractions of seconds.
AM/PM, am/pm, A/P, a/pAM/PM, am/pm, A/P, a/p Visualizza l'ora in base al formato a 12 ore.Displays the hour based on a 12-hour clock. La funzione Text restituisce "AM", "am", "A" o "a" per le ore da mezzanotte a mezzogiorno e "PM", "pm", "P" o "p" per le ore da mezzogiorno a mezzanotteText returns "AM", "am", "A", or "a" for times from midnight until noon and "PM", "pm", "P", or "p" for times from noon until midnight

Segnaposto letteraliLiteral placeholders

Nella stringa di formato è possibile includere uno qualsiasi dei caratteri seguenti.You can include any of these characters in your format string. La funzione Text li visualizzerà così come sono.They will appear in the result of Text as is. Altri caratteri sono riservati per futuri segnaposto e non devono essere usati.Additional characters are reserved for future placeholders, so you shouldn't use them.

CarattereCharacter DescrizioneDescription
Qualsiasi simbolo di valutaAny currency symbol Simbolo del dollaro, del centesimo, dell'euro e così viaDollar sign, cents sign, euro sign, etc.
+ Segno piùPlus sign
(( Parentesi apertaLeft parenthesis
:: Due puntiColon
^ Accento circonflessoCircumflex accent (caret)
'' ApostrofoApostrophe
{{ Parentesi graffa apertaLeft curly bracket
< Segno di minore aLess-than sign
= Segno di ugualeEqual sign
- Segno menoMinus sign
/ BarraSlash mark
)) Parentesi chiusaRight parenthesis
& E commercialeAmpersand
~ TildeTilde
}} Parentesi graffa chiusaRight curly bracket
> Segno di maggiore diGreater-than sign
  SpazioSpace character

App globaliGlobal apps

La funzione Text opera a livello globale.The Text function is globally aware. È infatti in grado di scrivere correttamente data, ora, valute e numeri per una vasta gamma di lingue.For a wide array of languages, it knows how to properly write out dates, times, currencies, and numbers. Per tale scopo, la funzione deve disporre delle due informazioni seguenti:To do its job, it needs two pieces of information:

  • Lingua del formato personalizzato: per gli autori, come deve essere interpretato un formato personalizzato?The language of the custom format: For authors, how should a custom format be interpreted? I caratteri separatori (.The separator characters (. e ,) hanno significati differenti in lingue diverse.and ,) have different meanings in different languages. Questa situazione viene gestita con un segnaposto speciale contenente un tag di lingua.This is handled with a special placeholder containing a language tag. Ancora più semplice, i formati di data/ora predefiniti sono indipendenti dalla lingua.Even easier, the predefined date/time formats are language agnostic.
  • Lingua del risultato: per gli utenti, quale lingua deve essere usata nel risultato della funzione?The language of the result: For users, what language should be used in the result of the function? I nomi dei mesi e dei giorni della settimana devono essere nella lingua dell'utente dell'app.Names for months and weekdays need to be in the appropriate language for the user of the app. Questa esigenza viene gestita fornendo un terzo argomento facoltativo alla funzione Text.This is handled with a third optional argument to the Text function.

Per entrambe, la lingua viene specificata con un tag di lingua.For both, the language is provided with a language tag. Per visualizzare l'elenco delle lingue supportate, digitare Text( 1234, "", ) nella barra della formula o nella visualizzazione avanzata e scorrere l'elenco delle impostazioni locali suggerite per il terzo argomento.To see the list of supported languages type Text( 1234, "", ) in the formula bar or advanced view and scroll through the list of locales suggested for the third argument.

Segnaposto della lingua in formato personalizzatoCustom format language placeholder

Per specificare la lingua del formato personalizzato, usare quanto segue:To specify the language of the custom format, use:

SegnapostoPlaceholder DescrizioneDescription
[$-LanguageTag][$-LanguageTag] LanguageTag è un tag di lingua restituito dalla funzione Language.LanguageTag is a language tag as returned from the Language function. Tale tag può indicare semplicemente la lingua, ad esempio [$-en] per l'inglese, o includere la regione geografica, ad esempio [$-en-GB] per specificare l'inglese della Gran Bretagna.It can be in the form of just the language such as [$-en] for English, or it can also include the region such as [$-en-GB] to further specify Great Britain.

Il segnaposto può apparire in qualunque punto del formato personalizzato, ma soltanto una volta.The language placeholder can appear anywhere in the custom format but only once.

Durante la scrittura di una formula, se non si specifica un segnaposto di lingua e la stringa di formato è ambigua da un punto di vista globale, lo strumento di creazione inserirà automaticamente il tag di lingua per la lingua corrente.While writing a formula, if you do not provide a language placeholder and the format string is ambiguous from a global standpoint, the authoring tool will automatically insert the language tag for your current language.

Se il segnaposto non è presente al momento dell'esecuzione dell'app, si presuppone che l'impostazione sia [$-en-US].[$-en-US] is assumed if this placeholder is not present when your app is run.

Nota

In una versione futura, la sintassi di questo segnaposto potrebbe essere modificata per evitare confusione con un segnaposto simile, ma diverso, supportato da Excel.In a future version, the syntax of this placeholder may change to avoid confusion with a similar, but different, placeholder supported by Excel.

Tag di lingua del risultatoResult language tag

Nel risultato della funzione Text sono presenti stringhe tradotte per il mese, il giorno della settimana e l'indicazione AM/PM, nonché i separatori decimali e di gruppo appropriati.Appearing in the result of Text are translated strings for month, weekday, and AM/PM designations, as well as the appropriate group and decimal separators.

Per impostazione predefinita, la funzione Text usa la lingua dell'utente che esegue l'applicazione.By default, Text uses the language of the user running the app. La funzione Language restituisce il tag di lingua relativo all'utente corrente.The Language function returns the language tag for the current user. È possibile sostituire questa impostazione predefinita fornendo alla funzione Text un tag di lingua per il terzo argomento facoltativo.You can override this default by supplying a language tag for the optional third argument to Text.

SintassiSyntax

Text( Number, DateTimeFormatEnum [, ResultLanguageTag ] )Text( Number, DateTimeFormatEnum [, ResultLanguageTag ] )

  • Number - Obbligatorio.Number - Required. Il valore numerico o di tipo data/ora da formattare.The number or the date/time value to format.
  • DateTimeFormat - Obbligatorio.DateTimeFormat - Required. Membro dell'enumerazione DateTimeFormat.A member of the DateTimeFormat enumeration.
  • ResultLanguageTag - Facoltativo.ResultLanguageTag - Optional. Il tag di lingua da usare per il testo del risultato.The language tag to use for the result text. Per impostazione predefinita, viene usata la lingua dell'utente corrente.By default, the language of the current user is used.

Text( Number, CustomFormat [, ResultLanguageTag ] )Text( Number, CustomFormat [, ResultLanguageTag ] )

  • Numero - Obbligatorio.Number - Required. Il valore numerico o di tipo data/ora da formattare.The number or the date/time value to format.
  • CustomFormat - Obbligatorio.CustomFormat - Required. Uno o più segnaposto racchiusi tra virgolette doppie.One or more placeholders enclosed in double quotation marks.
  • ResultLanguageTag - Facoltativo.ResultLanguageTag - Optional. Il tag di lingua da usare per il testo del risultato.The language tag to use for the result text. Per impostazione predefinita, viene usata la lingua dell'utente corrente.By default, the language of the current user is used.

EsempiExamples

L'utente che esegue queste formule si trova negli Stati Uniti e ha selezionato l'inglese come lingua.The user running these formulas is located in the United States and has selected English as their language. La funzione Language restituisce "en-US".The Language function is returning "en-US".

NumeroNumber

FormulaFormula DescrizioneDescription RisultatoResult
Text( 1234.59, "####.#" )Text( 1234.59, "####.#" ) Formatta il numero con una cifra decimale.Formats the number with one decimal place. "1234.6""1234.6"
Text( 8.9, "#.000" )Text( 8.9, "#.000" ) Se necessario, aggiunge zeri finali alla porzione decimale del numero.Pads the decimal portion of the number with trailing zeros, if needed. "8.900""8.900"
Text( 0.631, "0.#" )Text( 0.631, "0.#" ) Se necessario, aggiunge zeri iniziali alla porzione intera del numero.Pads the whole portion of the number with leading zeros, if needed. "0.6""0.6"
Text( 12, "#.0#" )Text( 12, "#.0#" )
Text( 1234.568, "#.0#" )Text( 1234.568, "#.0#" )
Aggiunge alla porzione decimale del numero degli zeri per una cifra decimale e include una seconda cifra decimale, se fornita.Pads the decimal portion of the number with zeros for one decimal place, and includes a second decimal place if supplied. "12.0""12.0"
"1234.57""1234.57"
Text( 12000, "$ #,###" )Text( 12000, "$ #,###" )
Text( 1200000, "$ #,###" )Text( 1200000, "$ #,###" )
Inserisce un separatore di migliaia ogni tre cifre e include un simbolo di valuta.Places a thousands separator every three digits, and includes a currency symbol. "$ 12,000""$ 12,000"
"$ 1,200,000""$ 1,200,000"

Data/oraDate/Time

  • At 2:37:47 PM on Monday, November 23, 2015At 2:37:47 PM on Monday, November 23, 2015
  • United States Pacific Time Zone (UTC-8)United States Pacific Time Zone (UTC-8)
FormulaFormula DescrizioneDescription RisultatoResult
Text( Now(), DateTimeFormat.LongDate )Text( Now(), DateTimeFormat.LongDate ) Esegue la formattazione come stringa data estesa in base alla lingua e alle impostazioni locali dell'utente corrente.Formats as a long date string, in the language and locale of the current user. "Monday, November 23, 2015""Monday, November 23, 2015"
Text( Now(), DateTimeFormat.LongDateTime )Text( Now(), DateTimeFormat.LongDateTime ) Esegue la formattazione come stringa data/ora estesa in base alla lingua e alle impostazioni locali dell'utente corrente usando il formato a 12 ore.Formats as a long date and time string, in the language and locale of the current user, using a 12-hour clock. "Monday, November 23, 2015 2:37:47 PM""Monday, November 23, 2015 2:37:47 PM"
Text( Now(), DateTimeFormat.LongTime24 )Text( Now(), DateTimeFormat.LongTime24 ) Esegue la formattazione come stringa ora estesa usando il formato a 24 ore.Formats as a long time string, using a 24-hour clock. "14:37:47""14:37:47"
Text( Now(), DateTimeFormat.ShortDate )Text( Now(), DateTimeFormat.ShortDate ) Esegue la formattazione come stringa data breve in base alla lingua e alle impostazioni locali dell'utente corrente.Formats as a short date string, in the language and locale of the current user. "11/23/2015""11/23/2015"
Text( Now(), "d-mmm-yy" )Text( Now(), "d-mmm-yy" ) Esegue la formattazione usando caratteri segnaposto:Formats using placeholder characters:
  • d per un giorno del mese a una cifra o a due cifred for a single-digit or double-digit day of the month
  • - come carattere letterale copiato nel risultato- as a literal character copied to the result
  • mmm per l'abbreviazione a tre lettere del mesemmm for a three-letter abbreviation of the month
  • - come un altro carattere letterale copiato nel risultato- as another literal character copied to the result
  • yy per l'abbreviazione a due cifre dell'annoyy for a two-digit abbreviation of the year
"23-Nov-15""23-Nov-15"

App globaliGlobal apps

FormulaFormula DescrizioneDescription RisultatoResult
Text( 1234567.89, "[$-en-US]$ #,###" )Text( 1234567.89, "[$-en-US]$ #,###" ) Interpreta , come separatore di raggruppamento inserito ogni tre caratteri e $ come simbolo di valuta.Interprets , as a grouping separator placed every three characters and $ as the currency symbol. Poiché non deve essere visualizzato alcun decimale, il valore viene arrotondato al successivo numero intero più elevato.As no decimals are to be displayed, the value is rounded up to the next higher whole number. In questo caso [$-en-US] è facoltativo, poiché si tratta dell'impostazione predefinita.The [$-en-US] is optional in this case, as this is the default. "$ 1,234,568""$ 1,234,568"
Text( 1234567.89, "[$-es-ES]€ #,###" )Text( 1234567.89, "[$-es-ES]€ #,###" ) Interpreta , come separatore decimale e come simbolo di valuta.Interprets , as a decimal separator and as the currency symbol. Poiché [$-fr-FR] determina soltanto il modo in cui viene interpretata la stringa di formato, il risultato userà i caratteri del tag di lingua predefinito "en-US": .Because the [$-fr-FR] only determines how the format string is interpreted, the result will use the characters from the default "en-US" lanugage tag: . (punto) come separatore decimale e $ per il simbolo di valuta.(period) for decimal separator and $ for currency symbol. "$ 1234567.89""$ 1234567.89"
Text( 1234567.89, "[$-es-ES]€ #,###", "es-ES" )Text( 1234567.89, "[$-es-ES]€ #,###", "es-ES" ) Interpreta , come separatore decimale.Interprets , as a decimal separator. Il tag di lingua del risultato è stato impostato su "fr-FR": di conseguenza, , (virgola) verrà usato come separatore decimale e come simbolo di valuta.The result language tag has been set to "fr-FR" which will result in , (comma) being used as the decimal separator and as the currency symbol. "€ 1234567,89""€ 1234567,89"
Text( Date(2016,1,31), "dddd mmmm d" )Text( Date(2016,1,31), "dddd mmmm d" ) Restituisce il giorno della settimana, il mese e il giorno del mese nella lingua dell'utente corrente.Returns the weekday, month, and day of the month in the language of the current user. Poiché nessuno dei segnaposto è dipendente dalla lingua, non è necessario un tag di lingua in formato testo.Because none of the placeholders are language dependent, there is no need for a format text language tag. "Saturday January 31""Saturday January 31"
Text( Date(2016,1,31), "dddd mmmm d", "es-ES" )Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) Restituisce il giorno della settimana, il mese e il giorno del mese nella lingua "es-ES".Returns the weekday, month, and day of the month in the "es-ES" language. "domingo enero 31""domingo enero 31"