Функция Language

Статья
03/22/2024

Применимо к: приложениям на основе холста классическим потокам интерфейсу командной строки Power Platform

Эта функция возвращает тег языка текущего пользователя.

Description

Функция Language возвращает язык, скрипт и регион текущего пользователя в качестве тега языка.

Используйте сведения о языке для настройки приложения в разных языковых стандартах. Например, если вы создаете приложение, которое будет использоваться в Италии и Франции, функцию Language можно задать таким образом, чтобы для пользователей в этих регионах автоматически отображались строки на итальянском и французском языке.

Теги языка

Тег языка может быть в одном из трех форматов:

Возвращаемое значение	Description
*"lg‑RE"*	lg — это двухсимвольное сокращенное название языка, а RE — региона. Это самый распространенный тип возвращаемого значения. Например, для Великобритании возвращается "en-GB".
"lg"	lg — это двухсимвольное сокращенное название языка. Этот формат используется, когда Power Apps содержит сведения о языке, но не об определенном регионе.
*"lg‑scrp‑RE"*	lg — это двухсимвольное сокращенное название языка, scrp — сокращенное название скрипта, состоящее из четырех символов, а RE — двухсимвольное сокращение названия региона.

Power Apps использует формат тега языка 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 в локальной файловой системе.
В Power Apps на панели справа откройте вкладку Источники данных, а затем нажмите кнопку Добавить источник данных.
Выберите Добавить статические данные для приложения, укажите сохраненный файл Excel и щелкните Открыть.
Выберите созданную таблицу, а затем щелкните Подключиться.

В приложении вместо текста Hello, который использовался ранее, вставьте следующую формулу:

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

Эта формула выполнит поиск соответствующего значения LocalizedText для языка пользователя. Если его не удастся обнаружить, будет возвращена пустая строка по умолчанию.

Имейте в виду, что длина строк, переведенных на другие языки, может существенно отличаться по сравнению с исходным языком. Во многих случаях метки и другие элементы, отображающие строки в пользовательском интерфейсе, могут оказаться шире после локализации.

Служба перевода

Вы можете перевести текст по запросу с помощью службы перевода, такой как Microsoft Translator.

В Power Apps на панели справа откройте вкладку Источники данных, а затем нажмите кнопку Добавить источник данных.
Щелкните Microsoft Translator.