Эта функция возвращает тег языка текущего пользователя.
Описание
Функция Language возвращает язык, скрипт и регион текущего пользователя в качестве тега языка.
Используйте сведения о языке для настройки приложения в разных языковых стандартах. Например, если вы создаете приложение, которое будет использоваться в Италии и Франции, функцию Language можно задать таким образом, чтобы для пользователей в этих регионах автоматически отображались строки на итальянском и французском языке.
Теги языка
Тег языка может быть в одном из трех форматов:
| Возвращаемое значение | Описание |
| "lg‑RE" | *lg* — это двухсимвольное сокращенное название языка, а *RE* — региона. Это самый распространенный тип возвращаемого значения. Например, для Великобритании возвращается "en-GB". |
| "lg" | *lg* — это двухсимвольное сокращенное название языка. Этот формат используется, когда PowerApps содержит сведения о языке, но не об определенном регионе. |
| "lg‑scrp‑RE" | *lg* — это двухсимвольное сокращенное название языка, *scrp* — сокращенное название скрипта, состоящее из четырех символов, а *RE* — двухсимвольное сокращение названия региона. |
PowerApps использует формат тега языка IETF BCP-47.
Чтобы увидеть список поддерживаемых тегов языка, введите в строке формул или в расширенном представлении команду Value( "1", ) и изучите список языковых обозначений, которые будут предложены в качестве значений для второго аргумента.
Функции Text и Value также используют теги языка. Используйте эти функции для преобразования содержимого в текстовые строки и наоборот в повсеместно известном формате. При передаче тега языка этим функциям, когда регион ни на что не влияет, можно использовать только языковую часть тега.
Синтаксис
Language()
Примеры
Языковой стандарт пользователя
Предполагается, что основная операционная система или браузер используют для расположения языковой стандарт по умолчанию.
| Формула | Расположение | Возвращаемое значение |
| Language() | Лиссабон, Португалия | "pt-PT" |
| Language() | Рио-де-Жанейро, Бразилия | "pt-BR" |
| Language() | Атланта, США | "en-US" |
| Language() | Манчестер, Соединенное Королевство | "en-GB" |
| Language() | Париж, Франция | "fr-FR" |
| Language() | Розо, Доминика | "en" |
| Language() | Белград, Сербия | "sr-cyrl-RS" или "sr-latn-RS" в зависимости от системных параметров пользователя |
Таблица локализации
Простой подход к локализации — создать электронную таблицу Excel, которая сопоставляет автора, определяемого TextID, с переведенным текстом для языка пользователя. Несмотря на то что вы можете использовать коллекцию или любой другой источник данных для этой таблицы, мы выбрали Excel, так как в этом формате переводчики могут легко редактировать текст и управлять им вне приложения.
Создайте следующую таблицу в Excel:
Запись с пустым значением в столбце Language будет использоваться по умолчанию, если для данного языка отсутствует определенная текстовая строка. Эта запись должна отображаться после всех других записей для данного TextID.
В этой статье мы рассматриваем только язык, а не регион. Если бы регион имел значение, мы бы добавили полное значение тега языка в приведенную выше таблицу.
Чтобы сделать это в соответствующей таблице Excel, на ленте Вставка выберите команду Таблица. По умолчанию таблица получит имя Table1, но его можно изменить на любое другое с помощью ленты Работа с таблицами/Конструктор и текстового поля Имя таблицы: в левой области.
Сохраните файл Excel в локальной файловой системе.
В PowerApps на панели справа откройте вкладку Источники данных, а затем щелкните Добавить источник данных.
Выберите Добавить статические данные для приложения, укажите сохраненный файл Excel и щелкните Открыть.
Выберите созданную таблицу, а затем щелкните Подключиться.
В приложении вместо текста Hello, который использовался ранее, вставьте следующую формулу:
- LookUp( Table1, TextID = "Hello" && (LanguageTag = Left( Language(), 2 ) || IsBlank( LanguageTag ))).LocalizedText
Эта формула выполнит поиск соответствующего значения LocalizedText для языка пользователя. Если его не удастся обнаружить, будет возвращена пустая строка по умолчанию.
Имейте в виду, что длина строк, переведенных на другие языки, может существенно отличаться по сравнению с исходным языком. Во многих случаях метки и другие элементы, отображающие строки в пользовательском интерфейсе, могут оказаться шире после локализации.
Служба перевода
Вы можете перевести текст по запросу с помощью службы перевода, такой как Microsoft Translator.
В PowerApps на панели справа откройте вкладку Источники данных, а затем щелкните Добавить источник данных.
Щелкните Microsoft Translator.
В приложении вместо текста Hello, который использовался ранее, вставьте следующую формулу:
- MicrosoftTranslator.Translate( "Hello", Language() )
Служба Microsoft Translator использует те же теги языка, которые возвращаются функцией Language.
Этот подход имеет некоторые недостатки по сравнению с предыдущим примером, в котором использовалась предварительно переведенная таблица текстовых строк.
- Процесс перевода займет некоторое время в связи с обращением к службе через сеть. Таким образом, вы сможете увидеть переведенный текст в приложении только через некоторое время.
- Перевод будет машинным, не лучшего качества и не лучшим вариантом перевода для вашего приложения.