Función Language
Aplícase a:
Aplicacións de lona Fluxos de escritorio Power Platform CLI
Devolve a etiqueta de idioma do usuario actual.
Descripción
A función Language devolve o idioma, o script e a rexión da etiqueta de idioma do usuario actual.
Use a información do idioma para adaptar a aplicación nas configuracións rexionais. Por exemplo, se está a crear unha aplicación que se empregará en Italia e Francia, pode empregar Language para amosar automaticamente aos seus usuarios as cadeas Italiano e Francés neses distintos lugares.
Etiquetas de idioma
Unha etiqueta de idioma pode estar nun destes tres formatos:
| Valor devolto | Descripción |
|---|---|
| "lg‑RE" | lg é a abreviatura de dous caracteres para a lingua e RE é a abreviatura de dous caracteres para a rexión. Este é o tipo devolto máis común. Por exemplo, devólvese "en-GB" para Gran Bretaña. |
| "lg" | lg é a abreviatura de dous caracteres do idioma. Este é o formato usado cando Power Apps ten información sobre o idioma, pero non ten información para a rexión específica. |
| "lg‑scrp‑RE" | lg é a abreviatura de dous caracteres para o idioma, scrp é a abreviatura de catro caracteres do script e RE é a abreviatura de dous caracteres para a rexión. |
Power Apps usa o formato de etiqueta de idioma IETF BCP-47.
Para ver a lista de etiquetas de idiomas compatibles, escriba Value( "1", ) na barra de fórmulas ou na vista avanzada e percorra a lista de configuracións rexionais suxeridas para o segundo argumento.
As funcións Text e Value tamén usan etiquetas de idioma. Use estas funcións para traducir de e ás cadeas de texto dunha forma globalmente consciente. Cando pasar unha etiqueta de idioma a estas funcións e a rexión non suporía ningunha diferenza, pode empregar só a parte de idioma da etiqueta.
Sintaxe
Language()
Exemplos
Configuración rexional do usuario
Suponse que o sistema operativo do servidor e/ou o navegador están a usar a configuración rexional predeterminada para a situación.
| Fórmula | Localización | Devolver valor |
|---|---|---|
| Language() | Lisboa, Portugal | "pt-PT" |
| Language() | Río de Xaneiro, Brasil | "pt-BR" |
| Language() | Atlanta, Estados Unidos | "en-US" |
| Language() | Manchester, Gran Bretaña | "en-GB" |
| Language() | París, Francia | "fr-FR" |
| Language() | Roseau, Dominica | "en" |
| Language() | Belgrado, Serbia | "sr-cyrl-RS" ou "sr-latn-RS", dependendo da configuración do sistema do usuario |
Táboa de localización
Un enfoque sinxelo para a localización é crear unha folla de cálculo de Excel asignando un TextID definido polo autor a un texto traducido para o idioma do usuario. Aínda que pode usar unha colección ou calquera outra orixe de datos para esta táboa, escollemos Excel porque é fácil de editar e xestionar fóra da aplicación por tradutores.
Cree a seguinte táboa en Excel:
A entrada con en branco para a columna Language usarase como predeterminada se non se atopa unha cadea de texto específica para un idioma dado. Esta entrada debe aparecer despois de todas as outras entradas dun TextID dado.
Para os nosos propósitos, só hai que mirar a lingua da configuración rexional e non a rexión. Se as consideracións rexionais fosen importantes, puidemos incluír o valor completo das etiquetas de idiomas na táboa anterior.
Use a fita Inserir, comando Táboa, para convertelo nunha táboa de Excel axeitada. De xeito predeterminado, nomearase Table1 pero pode nomealo como queira coa fita Deseño/ferramentas da táboa e a caixa de texto Nome da táboa: no extremo esquerdo.
Garde o ficheiro de Excel no seu sistema de ficheiros local.
En Power Apps, no panel dereito, faga clic ou toque no separador Orixes de datos e, a continuación, faga clic ou toque en Engadir orixe de datos.
Faga clic ou toque en Engadir datos estáticos á súa aplicación, faga clic ou toque o ficheiro Excel que gardou e logo faga clic ou toque Abrir.
Seleccione a táboa que creou e, a seguir, prema ou toque Conectar.
Na súa aplicación, onde queira que empregara o texto "Hello" antes, use esta fórmula no seu lugar:
- LookUp( Táboa1, TextID = "Ola" & (LanguageTag = Left( Language(), 2 ) || IsBlank(LanguageTag ))). LocalizedText
Esta fórmula buscará o valor LocalizedText axeitado para o idioma do usuario e, se non se atopa, volverá caer na versión en branco predeterminada.
Teña en conta que as cadeas traducidas noutros idiomas poden ser moito máis longas do que no seu idioma. En moitos casos, as etiquetas e outros elementos que mostran as cadeas na súa interface de usuario terán que ser máis amplos para adaptarse.
Translation service
Pode traducir texto a pedido empregando un servizo de tradución, como o servizo de Microsoft Translator:
- En Power Apps, no panel dereito, faga clic ou toque no separador Orixes de datos e, a continuación, faga clic ou toque en Engadir orixe de datos.
- Prema ou toque Microsoft Translator.
Na súa aplicación, onde queira que empregara o texto "Hello" antes, use esta fórmula no seu lugar:
- MicrosoftTranslator.Translate( "Hello", Language() )
O servizo Microsoft Translator usa as mesmas etiquetas de idioma que a función Language devolve.
Este enfoque inclúe algúns inconvenientes en comparación co exemplo anterior que utilizou unha táboa de cadeas de texto pretraducida:
- A tradución tardará un tempo en completarse, e requirirá unha chamada a un servizo na rede. Isto producirá un retraso para ver o texto traducido na súa aplicación.
- A tradución será mecánica e pode que non sexa o que anticipa nin que sexa a mellor opción para a situación da súa aplicación.