Compartir por


Language Función

Aplícase a: Aplicacións de lenzo Copilot Studio Fluxos de escritorio CLI de Power Platform Funcións de Dataverse Power Pages

Devolve a etiqueta de idioma do usuario actual.

Descripción

A Language función devolve o idioma, o script e a rexión do usuario actual como etiqueta de idioma.

Use a información do idioma para adaptar a aplicación nas configuracións rexionais. Por exemplo, se estás a crear unha aplicación que se usa en Italia e Francia, podes usar Language para mostrar automaticamente cadeas en italiano e francés aos teus usuarios nesas diferentes localizacións.

Language etiquetas

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. É o tipo de retorno máis común. Por exemplo, "en-GB" é devolto para o Reino Unido.
"lg" lg é a abreviatura de dous caracteres para a lingua. É o formato que se usa 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 para o guión 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 idioma soportadas, escriba Value("1",) na barra de fórmulas ou na vista avanzada e desprácese pola lista de localizacións 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 faría a diferenza, pode usar só a parte de idioma da etiqueta.

Sintaxe

Language()

Exemplos

Configuración rexional do usuario

Suponse que o sistema operativo host e/ou o navegador están a usar a localización predeterminada para a localizació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, Reino Unido "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 podes usar unha colección ou calquera outra fonte de datos para esta táboa, escollemos Excel porque é fácil de editar e xestionar fóra da aplicación por tradutores.

  1. Cree a seguinte táboa en Excel:

    Táboa de localización.

    A entrada con blank para a Language columna úsase como predeterminada se non se atopa ningunha cadea de texto específica para un idioma determinado. 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, poderiamos incluír o valor completo da etiqueta de idioma na táboa anterior.

  2. Use a fita Inserir, comando Táboa, para convertelo nunha táboa de Excel axeitada. Por defecto, chámase Táboa1 , pero podes nomearlle o que queiras coa cinta Ferramentas de táboa / Deseño e a caixa de texto Nome da táboa: no lado esquerdo.

  3. Garde o ficheiro de Excel no seu sistema de ficheiros local.

  4. En Power Apps, no panel dereito, prema ou toque a pestana Fontes de datos e, a seguir, prema ou toque Engadir fonte de datos.

  5. Prema ou toque Engadir datos estáticos á aplicación, prema ou toque o ficheiro de Excel que gardou e, a seguir, toque ou prema Abrir.

  6. Seleccione a táboa que creou e, a continuación, prema ou toque Conectar.

Na túa aplicación, onde usaches o texto "Ola" antes, usa esta fórmula no seu lugar:

  • LookUp( Table1, TextID = "Hello" &&(LanguageTag = Left( Language(), 2 ) || IsBlank( LanguageTag ))). Texto localizado

Esta fórmula buscará o valor LocalizedText adecuado para o idioma do usuario e, se non se atopa, volverá á versión en branco predeterminada.

As cadeas traducidas noutros idiomas poden ser máis longas que no teu idioma. En moitos casos, as etiquetas e outros elementos que mostran as cadeas na súa interface de usuario deben ser máis amplos para acomodarse.

Servizo de tradución

Pode traducir texto a pedido empregando un servizo de tradución, como o servizo de Microsoft Translator:

  1. 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.
  2. 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( "Ola", Language() )

O servizo Microsoft Translator usa as mesmas etiquetas de idioma que a Language función.

Este enfoque ten algúns inconvenientes en comparación co exemplo anterior que utilizaba unha táboa pretraducida de cadeas de texto:

  • A tradución leva tempo para completarse, requirindo unha chamada a un servizo a través da rede. Isto provoca un atraso para ver o texto traducido na túa aplicación.
  • A tradución é mecánica e pode non ser o que esperas ou ser a mellor opción para a situación dentro da túa aplicación.