hs.host.locale

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

• Нет

• массив строк, определяющих идентификаторы локалей, распознаваемые этой системой.

• эти значения могут быть использованы с hs.host.locale.details для получения подробной информации о конкретной локали.

Возвращает строку, определяющую идентификатор текущей локали пользователя.

• Нет

• строка, определяющая идентификатор текущей локали пользователя.

• это значение может быть использовано с hs.host.locale.details для получения подробной информации о возвращаемой локали.

Возвращает таблицу, содержащую информацию о текущей или указанной локали.

• identifier - необязательная строка, определяющая локаль, о которой требуется отобразить информацию. Если вы не укажете идентификатор, будет возвращена информация о текущей локали пользователя.

• таблица, содержащая одну или несколько из следующих пар ключ-значение:
  • alternateQuotationBeginDelimiterKey - строка, содержащая символ открывающей кавычки, связанный с локалью. В некоторых локалях при вложенных кавычках символы кавычек чередуются.
  • alternateQuotationEndDelimiterKey - строка, содержащая символ закрывающей кавычки, связанный с локалью. В некоторых локалях при вложенных кавычках символы кавычек чередуются.
  • calendar - таблица, содержащая пары ключ-значение, описывающие календарь, связанный с локалью. Таблица будет содержать одну или несколько из следующих пар:
    • AMSymbol - символ AM для времени в календаре локали.
    • calendarIdentifier - строка, представляющая идентификатор календаря.
    • eraSymbols - массив строк, определяющий названия эр, распознаваемые в календаре локали.
    • firstWeekday - индекс в weekdaySymbols первого дня недели в календаре локали.
    • longEraSymbols - массив строк, определяющий полные названия эр, распознаваемые в календаре локали.
    • minimumDaysInFirstWeek - минимальное количество дней, целое значение, в первой неделе в календаре локали.
    • monthSymbols - массив строк для месяцев года в календаре локали.
    • PMSymbol - символ PM для времени в календаре локали.
    • quarterSymbols - массив строк для кварталов года в календаре локали.
    • shortMonthSymbols - массив коротких строк для месяцев года в календаре локали.
    • shortQuarterSymbols - массив коротких строк для кварталов года в календаре локали.
    • shortStandaloneMonthSymbols - массив коротких отдельных строк для месяцев года в календаре локали.
    • shortStandaloneQuarterSymbols - массив коротких отдельных строк для кварталов года в календаре локали.
    • shortStandaloneWeekdaySymbols - массив коротких отдельных строк для дней недели в календаре локали.
    • shortWeekdaySymbols - массив коротких строк для дней недели в календаре локали.
    • standaloneMonthSymbols - массив отдельных строк для месяцев года в календаре локали.
    • standaloneQuarterSymbols - массив отдельных строк для кварталов года в календаре локали.
    • standaloneWeekdaySymbols - массив отдельных строк для дней недели в календаре локали.
    • veryShortMonthSymbols - массив очень коротких строк для месяцев года в календаре локали.
    • veryShortStandaloneMonthSymbols - массив очень коротких отдельных строк для месяцев года в календаре локали.
    • veryShortStandaloneWeekdaySymbols - массив очень коротких отдельных строк для дней недели в календаре локали.
    • veryShortWeekdaySymbols - массив очень коротких строк для дней недели в календаре локали.
    • weekdaySymbols - массив строк для дней недели в календаре локали.
  • collationIdentifier - строка, содержащая сортировку, связанную с локалью.
  • collatorIdentifier - строка, содержащая идентификатор сортировки для локали.
  • countryCode - строка, содержащая код страны локали.
  • currencyCode - строка, содержащая код валюты, связанный с локалью.
  • currencySymbol - строка, содержащая символ валюты, связанный с локалью.
  • decimalSeparator - строка, содержащая десятичный разделитель, связанный с локалью.
  • exemplarCharacterSet - массив строк, составляющих набор символов примера для локали.
  • groupingSeparator - строка, содержащая разделитель группировки чисел, связанный с локалью.
  • identifier - строка, содержащая идентификатор локали.
  • languageCode - строка, содержащая код языка локали.
  • measurementSystem - строка, содержащая систему измерения, связанную с локалью.
  • quotationBeginDelimiterKey - строка, содержащая символ открывающей кавычки, связанный с локалью.
  • quotationEndDelimiterKey - строка, содержащая символ закрывающей кавычки, связанный с локалью.
  • scriptCode - строка, содержащая код письма локали.
  • temperatureUnit - строка, содержащая предпочтительную систему измерения температуры.
  • timeFormatIs24Hour - булево значение, указывающее, выражается ли время в 24-часовом формате (true) или 12-часовом формате (false).
  • usesMetricSystem - булево значение, указывающее, использует ли локаль метрическую систему.
  • variantCode - строка, содержащая код варианта локали.

• Если вы указываете идентификатор локали в качестве аргумента, он должен быть основан на одной из строк, возвращаемых hs.host.locale.availableLocales. Использование произвольной строки может привести к ненадежным или несогласованным результатам.

• Apple не предоставляет документированный метод для получения пользовательских предпочтений относительно temperatureUnit или timeFormatIs24Hour. Методы определения этих значений основаны на коде из следующих источников:

  • temperatureUnit - http://stackoverflow.com/a/41263725
  • timeFormatIs24Hour - http://stackoverflow.com/a/1972487

• Если вы сможете определить дополнительные настройки локали или региона, которые не предоставляются этой функцией, и у вас есть источник, описывающий надежный метод получения этой информации, пожалуйста, отправьте вопрос на https://github.com/Hammerspoon/hammerspoon с деталями.

Возвращает локализованную строку для определенного кода языка.

• localeCode - код локали для локали, для которой требуется получить локализованную строку.
• baseLocaleCode - необязательная строка, определяющая локаль для использования в строке. Если вы не укажете baseLocaleCode, будет использована текущая локаль пользователя.

• строка, содержащая локализованную строку, или nil если либо localeCode, либо baseLocaleCode недопустимы. Например, если localeCode равно "de_CH", будет возвращено "Немецкий".
• строка, содержащая локализованную строку, включая диалект, или nil если либо localeCode, либо baseLocaleCode недопустимы. Например, если localeCode равно "de_CH", будет возвращено "Немецкий (Швейцария)".

• localeCode и необязательное baseLocaleCode должны быть одной из строк, возвращаемых hs.host.locale.availableLocales.

Возвращает порядок предпочтения языка пользователя в виде массива строк.

• Нет

• массив строк, определяющий предпочтительные языки пользователя в виде идентификаторов строк.

Регистрирует функцию, которая вызывается при изменении настроек языка пользователя.

• fn — функция, которая вызывается при изменении настройки

• строку uuid, которая может быть использована для отмены регистрации функции обратного вызова, когда больше не требуется уведомление о изменениях

• Функция обратного вызова не будет получать никаких аргументов и не должна возвращать ничего. Вы можете получить новые настройки языка с помощью hs.host.locale.localeInformation и проверить его ключи, чтобы определить, является ли изменение интересующим.

• Любое изменение в настройках языка и региона вызовет этот обратный вызов, даже изменения, которые не отражаются в информации о языке, предоставляемой hs.host.locale.localeInformation.

Отменяет регистрацию функции обратного вызова, когда больше не требуется отслеживать изменения языка пользователя.

• uuidString — строка uuid, возвращенная hs.host.locale.registerCallback при регистрации функции обратного вызова

• true, если функция обратного вызова была успешно отменена, или false, если нет, обычно потому, что строка uuid не соответствует текущей функции обратного вызова.