Translator

Объект для работы с переводами

Используется для локализации строк.

Hierarchy

  • Translator

Methods

T

  • T(str: string): string
  • T(str: string, locale: string): Promise<string>
  • Метод возвращает перевод строки исходя из локали пользователя.

    Для перевода используется локаль текущего пользователя, а если она не указана, то локаль компании.

    const res = SR.T('привет'); // return 'hello'
    

    Parameters

    • str: string

    Returns string

    Перевод строки.

  • Метод возвращает перевод строки исходя из переданной локали.

     // Получаем локаль компании
    const lang = await System.company.getLanguage();
    const locale = lang.code;
    // Переводим строку
    const res = SR.T('hello', locale);
    

    Parameters

    • str: string
    • locale: string

    Returns Promise<string>

    Перевод строки.

TF

  • TF(): function
  • TF(locale: string): function
  • Возвращает функцию для перевода шаблонной строки с подставленными в неё значениями параметров.

    Для перевода используется локаль текущего пользователя, а если она не указана, то локаль компании.

    const translated = SR.TF()`Осталось ${ number_of_hours } часов, ${ number_of_minutes } минут`;
    

    Перед подстановкой значений параметры примитивных типов автоматически преобразуются в строки.

    Для сложных типов, в том числе встроенных в TS SDK, необходимо выполнять преобразование в примитивный тип вручную.

    SR.TF()`Осталось ${ Context.data.duration.hours() } часов`;
    SR.TF()`Добро пожаловать, ${ Context.data.fio.lastname + " " + Context.data.fio.firstname }`;
    SR.TF()`Срок исполнения: ${ Context.data.date.format() }`;
    

    Returns function

    Функция для перевода шаблонной строки.

      • (strings: TemplateStringsArray, ...params: any[]): string
      • Parameters

        • strings: TemplateStringsArray
        • Rest ...params: any[]

        Returns string

  • Возвращает функцию для перевода шаблонной строки с подставленными в неё значениями параметров.

    Для перевода используется указанная локаль. Переводы для неё при необходимости загружаются перед применением.

    const translated = await SR.TF('en-US')`Осталось ${ number_of_hours } часов, ${ number_of_minutes } минут`;
    

    Перед подстановкой значений параметры примитивных типов автоматически преобразуются в строки.

    Для сложных типов, в том числе встроенных в TS SDK, необходимо выполнять преобразование в примитивный тип вручную.

    SR.TF('en-US')`Осталось ${ Context.data.duration.hours() } часов`;
    SR.TF('en-US')`Добро пожаловать, ${ Context.data.fio.lastname + " " + Context.data.fio.firstname }`;
    SR.TF('en-US')`Срок исполнения: ${ Context.data.date.format() }`;
    

    Parameters

    • locale: string

    Returns function

    Функция для перевода шаблонной строки.

      • (strings: TemplateStringsArray, ...params: any[]): Promise<string>
      • Parameters

        • strings: TemplateStringsArray
        • Rest ...params: any[]

        Returns Promise<string>