Funzione Text
Si applica a:
app canvas app canvas colonne di formula Dataverse app basate su modello Power Platform CLI
Converte qualsiasi valore e formatta un numero o un valore di data/ora in una stringa di testo.
Descrizione
La funzione Text formatta un valore numerico o di tipo data/ora sulla base di uno dei tipi di argomento seguenti:
- Un formato data/ora predefinito specificato mediante l'uso dell'enumerazione DateTimeFormat. Per le date e le ore, questo approccio è preferibile in quanto adatta automaticamente il valore alla lingua e all'area geografica dell'utente.
- Un formato personalizzato, che comprende una stringa di segnaposto che definisce, ad esempio, se i numeri mostrano un separatore decimale e se le date mostrano il nome completo del mese, il mese come abbreviazione o il mese come numero. Power Apps supporta un sottoinsieme di segnaposto di Microsoft Excel. In questa stringa, il segnaposto della lingua specifica la lingua in cui interpretare gli altri segnaposto. Se il formato personalizzato include un punto, ad esempio, il segnaposto in formato lingua specifica se il punto è un separatore decimale (ja-JP) o un separatore delle migliaia (es-ES).
Per altre informazioni, vedere Utilizzo di date e ore.
La funzione Text può anche convertire qualsiasi tipo di dati in una rappresentazione di testo usando un formato predefinito. Usala per passare valori non di testo a funzioni basate su testo come Len, Right e IsMatch.
Formati data/ora predefiniti
Per questi esempi, la data e l'ora utilizzate sono Tuesday, April 7, 2020 8:26:59.180 PM, nel fuso orario UTC-7 ore.
| Enum DateTimeFormat | Descrizione | Esempi (che utilizzano en-US) |
|---|---|---|
| LongDate | Anno di quattro cifre, anno, nome del mese, giorno del mese e giorno della settimana. I nomi del mese e del giorno della settimana non sono abbreviati. | "Tuesday, April 7, 2020" |
| LongDateTime | Anno di quattro cifre, nome del mese, giorno del mese e giorno della settimana più ora (formato a 12 ore), minuti, secondi e indicazione AM/PM. I nomi del mese e del giorno della settimana non sono abbreviati. | "Tuesday, April 7, 2020 8:26:59 PM" |
| LongDateTime24 | Anno di quattro cifre, mese, giorno del mese e giorno della settimana più ora (formato a 24 ore), minuti e secondi. I nomi del mese e del giorno della settimana non sono abbreviati. | "Tuesday, April 7, 2020 20:26:59" |
| LongTime | Ora (formato a 12 ore), minuti, secondi e indicazione AM/PM. | "8:26:59 PM" |
| LongTime24 | Ora (formato a 24 ore), minuti e secondi. | "20:26:59" |
| ShortDate | Anno in quattro cifre, mese e giorno del mese espressi in cifre. | "4/7/2020" |
| ShortDateTime | Anno in quattro cifre, mese e giorno del mese espressi in cifre, più ora (formato a 12 ore), minuti e indicazione AM/PM. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Anno in quattro cifre, mese e giorno del mese espressi in cifre, più ora (formato a 24 ore) e minuti. | "4/7/2020 20:26" |
| ShortTime | Ora (formato a 12 ore), minuti e indicazione AM/PM. | "8:26 PM" |
| ShortTime24 | Ora (formato a 24 ore) e minuti. | "20:26" |
| 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. | "2020-04-08T03:26:59.180Z" |
Segnaposto numerici
| Segnaposto | Descrizione |
|---|---|
| 0 (zero) | Visualizza gli zeri non significativi se un numero ha meno cifre di quanti sono gli zeri nel formato. Ad esempio, usa il formato #.00 per visualizzare 8.9 come 8.90. |
| # | Segue le stesse regole di 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. Ad esempio, viene visualizzato 8.9 se il formato personalizzato è #.## e il numero da formattare è 8.9. |
| . (period) | Visualizza il separatore decimale in un numero. Dipende dalla lingua del formato personalizzato. Per altre informazioni dettagliate, vedi global apps (App globali). |
| , (comma) | Visualizza il separatore di raggruppamento in un numero ed è spesso usato per le migliaia. La funzione Text separa i gruppi mediante virgole se il formato contiene una virgola racchiusa tra simboli di cancelletto (#) o tra zeri. Dipende dalla lingua del formato personalizzato. Per altre informazioni dettagliate, vedi global apps (App globali). |
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. Se a sinistra del separatore decimale è presente un numero di cifre superiore a quello dei segnaposto, le cifre eccedenti vengono visualizzate. 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.
Segnaposto di data e ora
| Segnaposto | Descrizione |
|---|---|
| m | Visualizza il mese sotto forma di numero senza zero iniziale. |
| mm | Visualizza il mese sotto forma di numero con uno zero iniziale quando appropriato. |
| mmm | Visualizza l'abbreviazione del mese (da Gen a Dic). |
| mmmm | Visualizza il nome completo del mese (da Gennaio a Dicembre). |
| g | Visualizza il giorno sotto forma di numero senza zero iniziale. |
| dd | Visualizza il giorno sotto forma di numero con uno zero iniziale quando appropriato. |
| ddd | Visualizza l'abbreviazione del giorno (da Dom a Sab). |
| dddd | Visualizza il nome completo del giorno (da Domenica a Sabato). |
| yy | Visualizza l'anno come numero di due cifre. |
| yyyy | Visualizza l'anno come numero di quattro cifre. |
| h | Visualizza l'ora sotto forma di numero senza zero iniziale. |
| hh | Visualizza il giorno sotto forma di numero con uno zero iniziale quando appropriato. Se il formato contiene AM o PM, l'ora viene visualizzata in base al formato a 12 ore. In caso contrario, l'ora viene visualizzata in base al formato a 24 ore. |
| m | Visualizza il minuto sotto forma di numero senza zero iniziale. Questo segnaposto 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. |
| mm | Visualizza il minuto sotto forma di numero con uno zero iniziale quando appropriato. Questo segnaposto deve comparire immediatamente dopo il segnaposto h o hh oppure immediatamente prima del segnaposto ss. In caso contrario, la funzione Text restituisce il mese anziché i minuti. |
| s | Visualizza il secondo sotto forma di numero senza zero iniziale. |
| ss | Visualizza il secondo sotto forma di numero con uno zero iniziale quando appropriato. |
| f | Visualizza le frazioni di secondo. |
| AM/PM, a/p | Visualizza l'ora in base al formato a 12 ore. La funzione Text restituisce "AM" o "a" per le ore da mezzanotte a mezzogiorno e "PM" o "p" per le ore da mezzogiorno a mezzanotte |
Segnaposto letterali
Nella stringa di formato puoi includere uno qualsiasi dei caratteri seguenti. La funzione Text li visualizzerà così come sono. Altri caratteri sono riservati per futuri segnaposto e non devono essere usati.
| Carattere | Descrizione |
|---|---|
| Qualsiasi simbolo di valuta | Simbolo del dollaro, del centesimo, dell'euro e così via |
| + | Segno più |
| ( | Parentesi aperta |
| : | Due punti |
| ^ | Accento circonflesso |
| ' | Apostrofo |
| { | Parentesi graffa aperta |
| < | Segno di minore a |
| = | Segno di uguale |
| - | Segno meno |
| / | Barra |
| ) | Parentesi chiusa |
| & | E commerciale |
| ~ | Tilde |
| } | Parentesi graffa chiusa |
| > | Segno di maggiore di |
| Spazio |
App globali
La funzione Text opera a livello globale. È infatti in grado di scrivere correttamente data, ora, valute e numeri per una vasta gamma di lingue. Per tale scopo, la funzione deve disporre delle due informazioni seguenti:
- Lingua del formato personalizzato: per i creatori autori, come deve essere interpretato un formato personalizzato? I caratteri separatori (. e ,) hanno significati differenti in lingue diverse. Se specifichi un formato personalizzato, puoi includere un segnaposto della lingua o usare il valore predefinito, che riflette la lingua impostata per il dispositivo. Ancora più semplice, puoi usare uno dei formati di data/ora predefiniti, che sono indipendenti dalla lingua.
- Lingua del risultato: per gli utenti, in quale lingua deve essere il risultato della funzione? I nomi di mesi e giorni della settimana devono essere nella lingua appropriata per l'utente dell'app, che puoi specificare aggiungendo un terzo argomento facoltativo alla funzione Text.
Per entrambi, specifichi la lingua utilizzando un tag di lingua. Per visualizzare l'elenco delle lingue supportate, digita Text( 1234, "", ) nella barra della formula o nella scheda Avanzate del riquadro a destra e scorri l'elenco delle impostazioni locali suggerite per il terzo argomento.
Segnaposto della lingua
Per specificare la lingua del formato personalizzato, usa:
| Segnaposto | Descrizione |
|---|---|
| [$-LanguageTag] | LanguageTag è un tag di lingua restituito dalla funzione Language. Il tag può indicare semplicemente la lingua, ad esempio [$-en] per l'inglese, o specificare anche l'area geografica, ad esempio [$-en-GB] per specificare l'inglese della Gran Bretagna. |
Il segnaposto può apparire in qualunque punto del formato personalizzato, ma soltanto una volta.
Se specifichi un formato personalizzato senza segnaposto della lingua e il formato è ambiguo da un punto di vista globale, il tag di lingua per la lingua corrente viene inserito automaticamente.
Se il segnaposto non è presente al momento dell'esecuzione dell'app, si presuppone che l'impostazione sia [$-en-US].
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.
Tag di lingua del risultato
Il risultato della funzione Text include stringhe tradotte per il mese, il giorno della settimana e l'indicazione AM/PM, nonché i separatori decimali e di gruppo appropriati.
Per impostazione predefinita, la funzione Text usa la lingua dell'utente che esegue l'applicazione. La funzione Language restituisce il tag di lingua relativo all'utente corrente. È possibile sostituire questo valore predefinito fornendo alla funzione Text un tag di lingua per il terzo argomento.
Sintassi
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime: obbligatorio. Il valore numerico o di tipo data/ora da formattare.
- DateTimeFormat: obbligatorio. Membro dell'enumerazione DateTimeFormat.
- ResultLanguageTag: facoltativo. Il tag di lingua da usare per il testo del risultato. Per impostazione predefinita, viene usata la lingua dell'utente corrente.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Number: obbligatorio. Il valore numerico o di tipo data/ora da formattare.
- CustomFormat: obbligatorio. Uno o più segnaposto racchiusi tra virgolette doppie.
- ResultLanguageTag: facoltativo. Il tag di lingua da usare per il testo del risultato. Per impostazione predefinita, viene usata la lingua dell'utente corrente.
Text( AnyValue )
- AnyValue: obbligatorio. Valore da convertire in una rappresentazione di testo. Viene utilizzato un formato predefinito.
Text ( Untyped )
- Untyped: obbligatorio. Oggetto non tipizzato che rappresenta una stringa. I valori accettabili dipendono dal provider non tipizzato. Per JSON, se l'oggetto non digitato è un numero o un valore booleano, verrà convertito in testo.
Esempi
Se non diversamente specificato, l'utente che esegue queste formule si trova negli Stati Uniti e ha selezionato l'inglese come lingua. La funzione Language restituisce "en-US".
Numero
| Formula | Descrizione | Risultato |
|---|---|---|
| Text( 1234.59, "####.#" ) | Formatta il numero con una cifra decimale. | "1234.6" |
| Text( 8.9, "#.000" ) | Se necessario, aggiunge zeri finali alla porzione decimale del numero. | "8.900" |
| Text( 0.631, "0.#" ) | Se necessario, aggiunge zeri iniziali alla porzione intera del numero. | "0.6" |
| Text( 12, "#.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. | "12.0" "1234.57" |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Inserisce un separatore di migliaia ogni tre cifre e include un simbolo di valuta. | "$ 12,000" "$ 1,200,000" |
Data/ora
- At 2:37:47 PM on Monday, November 23, 2015
- United States Pacific Time Zone (UTC-8)
| Formula | Descrizione | Risultato |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Esegue la formattazione come stringa data estesa in base alla lingua e alle impostazioni locali dell'utente corrente. | "Monday, November 23, 2015" |
| 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. | "Monday, November 23, 2015 2:37:47 PM" |
| Text( Now(), DateTimeFormat.LongTime24 ) | Esegue la formattazione come stringa ora estesa usando il formato a 24 ore. | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | Esegue la formattazione come stringa data breve in base alla lingua e alle impostazioni locali dell'utente corrente. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | Esegue la formattazione usando caratteri segnaposto:
|
"23-Nov-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Mostra un valore data-ora Unix in formato leggibile se moltiplichi il valore di origine per 1.000. | "Nov. 23, 2015 (02:47:37 PM)" |
App globali
| Formula | Descrizione | Result |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Mostra uno spazio come separatore di raggruppamento, la virgola come separatore decimale e € come simbolo della valuta. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Se i dati di origine seguono l'usanza francese di utilizzare una virgola come separatore decimale, devi modificare le impostazioni internazionali in francese e separare gli argomenti con un punto e virgola anziché una virgola per ottenere lo stesso risultato di cui sopra. | "1 234 567,89 €" |
| 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. Poiché nessuno dei segnaposto è dipendente dalla lingua, non è necessario un tag di lingua in formato testo. | "Domenica 31 gennaio" |
| 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". | "domingo enero 31" |
Conversione di valori in testo
| Formula | Descrizione | Risultato |
|---|---|---|
| Text( 1234567.89 ) | Converte un numero in una stringa. Non ci sono separatori di migliaia o controlli sul numero di cifre prima o dopo il separatore decimale; per un maggiore controllo, fornisci il segnaposto di numero come secondo argomento. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | Converte un valore data/ora in una stringa di testo. Per controllare la conversione, fornisci un membro dell'enumerazione DateTimeFormat o una stringa di formato personalizzato. | "1/4/2003 12:00 AM" |
| Text( true ) | Converte un valore booleano in una stringa. | "true" |
| Text( GUID() ) | Converte un valore GUID generato in una stringa. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Restituisce i primi quattro caratteri di un GUID generato. | "2d9c" |