Класс QLocale

Класс QLocale преобразует числа и их строковые представления в различных языках. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Примечание: Все функции в этом классе являются повторно входящими с исключениями:

• setDefault()

Открытые типы

Открытые функции

Статические публичные члены

Связанные нечлены

Подробное описание

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

Пример:

QLocale egyptian(QLocale::Arabic, QLocale::Egypt);
QString s1 = egyptian.toString(1.571429E+07, 'e');
QString s2 = egyptian.toString(10);

double d = egyptian.toDouble(s1);
int i = egyptian.toInt(s2);

QLocale поддерживает понятие локального объекта по умолчанию, который определяется из системных настроек локализации при запуске приложения. Локальный объект по умолчанию может быть изменён с помощью вызова статического члена setDefault(). Установка локального объекта по умолчанию имеет следующие эффекты:

• Если объект QLocale создаётся с конструктором по умолчанию, он будет использовать настройки локального объекта по умолчанию.
• QString::arg() использует локальный объект по умолчанию для форматирования числа, когда его спецификатор позиции в строке формата содержит 'L', например "%L1".

Следующий пример иллюстрирует, как использовать QLocale непосредственно:

bool ok;
double d;

QLocale::setDefault(QLocale::C);      // uses '.' as a decimal point
QLocale cLocale;                      // default-constructed C locale
d = cLocale.toDouble("1234,56", &ok); // ok == false, d == 0
d = cLocale.toDouble("1234.56", &ok); // ok == true,  d == 1234.56

QLocale::setDefault(QLocale::German); // uses ',' as a decimal point
QLocale german;                       // default-constructed German locale
d = german.toDouble("1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble("1234.56", &ok);  // ok == false, d == 0

QLocale::setDefault(QLocale::English);
// Default locale now uses ',' as a group separator.
QString str = QString("%1 %L2 %L3").arg(12345).arg(12345).arg(12345, 0, 16);
// str == "12345 12,345 3039"

Альтернативный метод для создания объекта QLocale — указание имени локали.

QLocale korean("ko");
QLocale swiss("de_CH");

Этот конструктор считывает язык, сценарий и/или территорию из заданного имени, принимая в качестве разделителя подчёркивание или дефис (и игнорируя любые заключительные .codeset или @variant суффикс).

Данные QLocale основаны на Common Locale Data Repository v40.

Сопоставление комбинаций языка, сценария и территории

QLocale имеет данные, полученные из CLDR, для многих комбинаций языка, сценария и территории, но не для всех. Если он создаётся со всеми тремя этими ключевыми значениями (при этом AnyLanguage, AnyScript или AnyTerritory считаются не указанными) и QLocale имеет данные для данной комбинации, эти данные используются. В противном случае QLocale делает всё возможное, чтобы найти разумную комбинацию языка, сценария и территории, для которой у него есть данные, соответствующие указанным.

CLDR предоставляет таблицы вероятных комбинаций, которые используются для заполнения любых неопределённых ключей; если QLocale имеет данные для результата такой вероятной комбинации, это используется. Если язык не указан и не может быть определён по сценарию и территории, или если QLocale не имеет данных для языка, используется локаль "C" (при чтении ключей из строки) или локаль по умолчанию (в противном случае).

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

Используйте language(), script() и territory() для определения фактически используемых ключей.

См. также QString::arg() и QInputMethod::locale().

Документация по типу члена

перечисление QLocale::Country

Это перечисление используется для идентификации территории.

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

См. такжеterritory(), territoryToString(), codeToTerritory(), и territoryToCode().

Перечисление QLocale::CurrencySymbolFormat

Определяет формат символа валюты.

[since 5.10] Перечисление QLocale::DataSizeFormatфлаги QLocale::DataSizeFormats

Определяет формат представления количеств данных.

Это перечисление было добавлено или изменено в Qt 5.10.

Тип DataSizeFormats является типом-псевдонимом для QFlags<DataSizeFormat>. Он хранит логическое ИЛИ сочетание значений DataSizeFormat.

См. такжеformattedDataSize().

[since 5.7] Перечисление QLocale::FloatingPointPrecisionOption

Это перечисление определяет константу, которая может быть задана как точность для QString::number(), QByteArray::number() и QLocale::toString() при преобразовании чисел с плавающей точкой или двойной точности, чтобы выразить переменное количество цифр как точность.

Этот перечисление был добавлен или изменен в Qt 5.7.

См. также toString(), QString::number(), и QByteArray::number().

перечисление QLocale::FormatType

Это перечисление описывает различные форматы, которые могут быть использованы при преобразовании объектов QDate, QTime и QDateTime, а также месяцев и дней, в строки, специфичные для текущего языка.

См. также dateFormat(), timeFormat(), dateTimeFormat(), monthName(), standaloneMonthName(), dayName(), standaloneDayName(), toDate(), toTime(), и toDateTime().

перечисление QLocale::Language

Это перечисление используется для указания языка.

См. также language() и languageToString().

Перечисление QLocale::MeasurementSystem

Это перечисление определяет, какие единицы используются для измерения.

Перечисление QLocale::NumberOptionфлаги QLocale::NumberOptions

Это перечисление определяет набор опций для преобразования чисел в строки и строк в числа. Их можно получить с помощью numberOptions() и установить с помощью setNumberOptions().

Тип NumberOptions является псевдонимом для QFlags<NumberOption>. Он хранит объединение значений NumberOption.

См. также setNumberOptions(), numberOptions() и FloatingPointPrecisionOption.

Перечисление QLocale::QuotationStyle

Этот перечисление определяет набор возможных стилей для цитат, специфичных для языка.

См. такжеquoteString().

перечисление QLocale::Script

Это перечисление используется для указания скрипта.

См. также script(), scriptToString() и languageToString().

[alias] QLocale::Территория

Этот тип перечисления — псевдоним для Country, который будет переименован в Территория в будущей версии.

См. также territory() и territoryToString().

Документация функций-членов

QLocale::QLocale(const QLocale &other)

Создаёт объект QLocale как копию other.

QLocale::QLocale(QLocale::Language language, QLocale::Script script = AnyScript, QLocale::Territory territory = AnyTerritory)

Создаёт объект QLocale для указанного language, script и territory.

Если у QLocale нет данных для данного сочетания, он найдёт данные для наилучшего совпадения. Он возвращается к локальной настройке по умолчанию, если

• language — AnyLanguage и язык нельзя вывести из script и territory
• у QLocale нет данных для языка, заданного как language или выведенного выше.

См. также setDefault() и Совместимые сочетания языка, письма и территории.

QLocale::QLocale(QLocale::Language language, QLocale::Territory territory)

Создаёт объект QLocale для указанного language и territory.

Если для этого сочетания используется более одного письма, выбирается наиболее вероятное письмо. Если у QLocale нет данных для заданного language, используется локальная настройка по умолчанию. Если у QLocale нет данных для заданного сочетания language и territory, может быть использована альтернативная территория.

См. также setDefault() и Совместимые сочетания языка, письма и территории.

QLocale::QLocale(const QString &name)

Создаёт объект QLocale с заданным name, имеющим формат "язык[_письмо][_территория][.кодировка][@модификатор]" или "C", где:

• язык — двухбуквенный код языка ISO 639 в нижнем регистре (также распознаются некоторые трёхбуквенные коды),
• письмо — четырёхбуквенный код письма ISO 15924 в верхнем регистре,
• территория — двухбуквенный код территории ISO 3166 в верхнем регистре (также распознаются некоторые числовые коды), и
• кодировка и модификатор игнорируются.

Разделителем может быть либо нижнее подчеркивание '_' (U+005F), либо дефис '-' (U+002D). Если у QLocale нет данных для заданного сочетания языка, письма и территории, то он использует лучшее подходящее соответствие. Если строка нарушает формат локали, или подходящие данные для указанных ключей не найдены, используется локаль "C".

Этот конструктор намного медленнее, чем QLocale(Language, Script, Territory) или QLocale(Language, Territory).

См. также bcp47Name() и Совместимые сочетания языка, письма и территории.

QLocale::QLocale()

Создаёт объект QLocale, инициализированный локальной настройкой по умолчанию.

Если локальная настройка по умолчанию не была установлена с помощью setDefault(), эта локальная настройка будет такой же, как возвращаемая system().

См. также setDefault().

QLocale &QLocale::operator=(const QLocale &other)

Присваивает other этому объекту QLocale и возвращает ссылку на этот объект QLocale.

QLocale::~QLocale()

Деструктор

QString QLocale::amText() const

Возвращает локализованное название суффикса "AM" для времени, указанного с использованием правил 12-часового формата.

См. также pmText().

QString QLocale::bcp47Name() const

Возвращает строку с разделителем дефис для языка, письма и страны (и, возможно, других полей BCP47) этой локали.

В отличие от uiLanguages(), возвращаемое значение bcp47Name() представляет имя локали данных QLocale, но не язык, на котором должен быть интерфейс пользователя.

Эта функция пытается привести имя локали в соответствие с BCP47.

См. также language(), territory(), script() и uiLanguages().

[static] QLocale QLocale::c()

Возвращает объект QLocale, инициализированный локалью "C".

Эта локаль основана на en_US, но имеет свои особенности, такие как упрощённый формат чисел и собственный формат даты. Она реализует стандарты POSIX, которые описывают поведение функций стандартной библиотеки языка программирования "C".

Среди прочего это означает, что порядок сортировки основан на ASCII-значениях букв, так что (при сортировке, учитывающей регистр) все заглавные буквы предшествуют любым строчным (вместо того, чтобы верхний и нижний регистры каждой буквы располагались рядом друг с другом, перед следующей буквой).

См. также system().

[static, since 6.1] QLocale::Language QLocale::codeToLanguage(QStringView languageCode)

Возвращает перечисление QLocale::Language, соответствующее двух- или трёхбуквенному languageCode, определённому в стандартах ISO 639.

Если код недопустим или неизвестен, возвращается QLocale::AnyLanguage.

Эта функция была добавлена в Qt 6.1.

См. также languageToCode(), codeToTerritory() и codeToScript().

[static, since 6.1] QLocale::Script QLocale::codeToScript(QStringView scriptCode)

Возвращает перечисление QLocale::Script, соответствующее четырёхбуквенному scriptCode письма, определённому в стандарте ISO 15924.

Если код недопустим или неизвестен, возвращается QLocale::AnyScript.

Эта функция была добавлена в Qt 6.1.

См. также scriptToCode(), codeToLanguage() и codeToTerritory().

[static, since 6.2] QLocale::Territory QLocale::codeToTerritory(QStringView territoryCode)

Возвращает перечисление QLocale::Territory, соответствующее двухбуквенному или трёхзначному territoryCode, определённому в стандарте ISO 3166.

Если код недопустим или неизвестен, возвращается QLocale::AnyTerritory.

Эта функция была добавлена в Qt 6.2.

См. также territoryToCode(), codeToLanguage() и codeToScript().

[since 5.13] QLocale QLocale::collation() const

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

Результат обычно равен этой локали; однако, системная локаль (которая обычно является локалью по умолчанию) вернёт системную локаль сортировки. Результат подходит для передачи в конструктор QCollator.

Эта функция была добавлена в Qt 5.13.

См. также QCollator.

QString QLocale::createSeparatedList(const QStringList &list) const

Возвращает строку, представляющую объединение данного списка строк list с разделителем, определённым локалью.

QString QLocale::currencySymbol(QLocale::CurrencySymbolFormat format = CurrencySymbol) const

Возвращает символ валюты в соответствии с format.

QString QLocale::dateFormat(QLocale::FormatType format = LongFormat) const

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

Если format — LongFormat, формат будет подробным, в противном случае — коротким. Например, LongFormat для локали en_US — dddd, MMMM d, yyyy, ShortFormat — M/d/yy.

См. также QDate::toString() и QDate::fromString().

QString QLocale::dateTimeFormat(QLocale::FormatType format = LongFormat) const

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

Если format равен LongFormat, формат будет подробным, в противном случае — коротким. Например, LongFormat для региона en_US равен dddd, MMMM d, yyyy h:mm:ss AP t, а ShortFormat — M/d/yy h:mm AP.

См. также QDateTime::toString() и QDateTime::fromString().

QString QLocale::dayName(int day, QLocale::FormatType type = LongFormat) const

Возвращает локальное имя day (где 1 соответствует понедельнику, 2 — вторнику и т. д.) в формате, заданном type.

Например, если регион равен en_US и day равен 1, LongFormat вернёт Monday, ShortFormat — Mon, а NarrowFormat — M.

См. также monthName() и standaloneDayName().

QString QLocale::decimalPoint() const

Возвращает символ десятичной точки для данного региона.

См. также groupSeparator() и toString().

QString QLocale::exponential() const

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

См. также toString(double, char, int).

Qt::DayOfWeek QLocale::firstDayOfWeek() const

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

[since 5.10] QString QLocale::formattedDataSize(qint64 bytes, int precision = 2, QLocale::DataSizeFormats format = DataSizeIecFormat) const

Преобразует размер в байтах в удобочитаемую локальную строку, содержащую число и единицу измерения. Кратность выбирается таким образом, чтобы число было не меньше единицы и как можно меньше. Например, если bytes равен 16384, precision равен 2, а format равен DataSizeIecFormat (по умолчанию), эта функция возвращает "16,00 KiБ"; для 1330409069609 байтов — "1,21 GiБ" и так далее. Если format равен DataSizeIecFormat или DataSizeTraditionalFormat, заданное количество байтов делится на степень 1024, с результатом меньше 1024; для DataSizeSIFormat — на степень 1000, с результатом меньше 1000. DataSizeIecFormat использует новые стандартные IEC-приставки Ki, Mi и т. д., тогда как DataSizeSIFormat использует старые SI-приставки к, М и т. д., а DataSizeTraditionalFormat ими злоупотребляет.

Эта функция была добавлена в Qt 5.10.

QString QLocale::groupSeparator() const

Возвращает разделитель групп цифр для данного региона.

См. также decimalPoint() и toString().

QLocale::Language QLocale::language() const

Возвращает язык этого региона.

См. также script(), territory(), languageToString() и bcp47Name().

[static, since 6.1] QString QLocale::languageToCode(QLocale::Language language)

Возвращает двух- или трехбуквенный код языка для language, определённый стандартами ISO 639.

Эта функция была добавлена в Qt 6.1.

См. также codeToLanguage(), language(), name(), bcp47Name(), territoryToCode() и scriptToCode().

[static] QString QLocale::languageToString(QLocale::Language language)

Возвращает QString, содержащий имя языка language.

См. также territoryToString(), scriptToString() и bcp47Name().

[static] QList<QLocale> QLocale::matchingLocales(QLocale::Language language, QLocale::Script script, QLocale::Territory territory)

Возвращает список допустимых объектов региона, которые соответствуют заданному language, script и territory.

Получение списка всех регионов: QList<QLocale> allLocales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::AnyTerritory);

Получение списка регионов, подходящих для России: QList<QLocale> locales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::Russia);

QLocale::MeasurementSystem QLocale::measurementSystem() const

Возвращает систему измерения для данного региона.

QString QLocale::monthName(int month, QLocale::FormatType type = LongFormat) const

Возвращает локальное имя month в формате, заданном type.

Например, если регион равен en_US и month равен 1, LongFormat вернёт January. ShortFormat — Jan, а NarrowFormat — J.

См. также dayName() и standaloneMonthName().

QString QLocale::name() const

Возвращает язык и страну данного региона в виде строки формата "язык_страна", где язык — двухбуквенный код языка ISO 639 в нижнем регистре, а страна — двух- или трехбуквенный код страны ISO 3166 в верхнем регистре.

Обратите внимание, что даже если объект QLocale был создан с явным указанием сценария, имя() не будет его содержать по соображениям совместимости. Используйте bcp47Name(), если вам нужно полное имя региона.

См. также QLocale(), language(), script(), territory() и bcp47Name().

QString QLocale::nativeLanguageName() const

Возвращает собственное название языка для данного региона. Например, "Schwiizertüütsch" для швейцарско-немецкого региона.

См. также nativeTerritoryName() и languageToString().

[since 6.2] QString QLocale::nativeTerritoryName() const

Возвращает собственное название территории для данного региона. Например, "España" для испанского/Испания.

Эта функция была добавлена в Qt 6.2.

См. также nativeLanguageName() и territoryToString().

QString QLocale::negativeSign() const

Возвращает символ минуса для данного региона.

См. также positiveSign() и toString().

QLocale::NumberOptions QLocale::numberOptions() const

Возвращает параметры, связанные с преобразованиями чисел для этого экземпляра QLocale.

По умолчанию для стандартных регионов параметры не установлены, за исключением региона "C", у которого параметр OmitGroupSeparator установлен по умолчанию.

См. также setNumberOptions(), toString(), groupSeparator() и FloatingPointPrecisionOption.

QString QLocale::percent() const

Возвращает символ процента для данного региона.

См. также toString().

QString QLocale::pmText() const

Возвращает локализованное имя суффикса «PM» для времени, указанного с использованием 12-часового формата.

См. также amText().

QString QLocale::positiveSign() const

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

См. также negativeSign() и toString().

QString QLocale::quoteString(const QString &str, QLocale::QuotationStyle style = StandardQuotation) const

Возвращает строку str, заключённую в кавычки в соответствии с текущей локалью, используя заданный стиль кавычек style.

[since 6.0] QString QLocale::quoteString(QStringView str, QLocale::QuotationStyle style = StandardQuotation) const

Это перегруженный метод.

Этот метод был добавлен в Qt 6.0.

QLocale::Script QLocale::script() const

Возвращает сценарий (алфавит) этой локали.

См. также language(), territory(), languageToString(), scriptToString() и bcp47Name().

[static, since 6.1] QString QLocale::scriptToCode(QLocale::Script script)

Возвращает четырёхбуквенный код сценария (алфавита) для script, как определено в стандарте ISO 15924.

Этот метод был добавлен в Qt 6.1.

См. также script(), name(), bcp47Name(), languageToCode() и territoryToCode().

[static] QString QLocale::scriptToString(QLocale::Script script)

Возвращает QString, содержащий имя script.

См. также languageToString(), territoryToString(), script() и bcp47Name().

[static] void QLocale::setDefault(const QLocale &locale)

Устанавливает глобальную стандартную локаль на locale. Эти значения используются при создании объекта QLocale без аргументов. Если этот метод не вызывается, используется системная локаль.

См. также system() и c().

void QLocale::setNumberOptions(QLocale::NumberOptions options)

Устанавливает options, относящиеся к преобразованию чисел для данного экземпляра QLocale.

См. также numberOptions() и FloatingPointPrecisionOption.

QString QLocale::standaloneDayName(int day, QLocale::FormatType type = LongFormat) const

Возвращает локализованное имя day (где 1 соответствует понедельнику, 2 — вторнику и так далее), используемого как самостоятельный текст, в формате, заданном параметром type.

Если информация о локали не содержит самостоятельного имени дня, возвращается значение, такое же, как в dayName().

См. также dayName() и standaloneMonthName().

QString QLocale::standaloneMonthName(int month, QLocale::FormatType type = LongFormat) const

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

Если информация о локали не содержит самостоятельного имени месяца, возвращается значение, такое же, как в monthName().

См. также monthName() и standaloneDayName().

[since 5.6] void QLocale::swap(QLocale &other)

Меняет местами локаль other с текущей локалью. Это очень быстро и никогда не терпит неудачу.

Этот метод был добавлен в Qt 5.6.

[static] QLocale QLocale::system()

Возвращает объект QLocale, инициализированный системной локалью.

Системная локаль может использовать системные источники данных локали, если они доступны, в противном случае обращается к внутренней базе данных QLocale для языка, сценария и региона, которые сообщает система.

Например, в Windows и macOS эта локаль будет использовать символы десятичного разделителя/разделителя групп и форматы даты/времени, указанные в панели системных настроек.

См. также c().

[since 6.2] QLocale::Territory QLocale::territory() const

Возвращает регион (территорию) этой локали.

Этот метод был добавлен в Qt 6.2.

См. также language(), script(), territoryToString() и bcp47Name().

[static, since 6.2] QString QLocale::territoryToCode(QLocale::Territory territory)

Возвращает двухбуквенный код региона (территории) для territory, как определено в стандарте ISO 3166.

Этот метод был добавлен в Qt 6.2.

См. также codeToTerritory(), territory(), name(), bcp47Name(), languageToCode() и scriptToCode().

[static, since 6.2] QString QLocale::territoryToString(QLocale::Territory territory)

Возвращает QString, содержащий имя territory.

Этот метод был добавлен в Qt 6.2.

См. также languageToString(), scriptToString(), territory() и bcp47Name().

Qt::LayoutDirection QLocale::textDirection() const

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

QString QLocale::timeFormat(QLocale::FormatType format = LongFormat) const

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

Если format равен LongFormat, формат будет подробным, в противном случае — коротким. Например, LongFormat для локали en_US это h:mm:ss AP t, ShortFormat — h:mm AP.

См. также QTime::toString() и QTime::fromString().

QString QLocale::toCurrencyString(qlonglong value, const QString &symbol = QString()) const

Возвращает локализованную строковую представление value в качестве валюты. Если предоставлен параметр symbol, он используется вместо символа валюты по умолчанию.

См. также currencySymbol().

QString QLocale::toCurrencyString(qulonglong value, const QString &symbol = QString()) const

Это перегруженный метод.

QString QLocale::toCurrencyString(short value, const QString &symbol = QString()) const

Это перегруженный метод.

QString QLocale::toCurrencyString(ushort value, const QString &symbol = QString()) const

Это перегруженный метод.

QString QLocale::toCurrencyString(int value, const QString &symbol = QString()) const

Это перегруженный метод.

QString QLocale::toCurrencyString(uint value, const QString &symbol = QString()) const

Это перегруженный метод.

[since 5.7] QString QLocale::toCurrencyString(double value, const QString &symbol = QString(), int precision = -1) const

Этот метод перегружает toCurrencyString().

Возвращает локализованное строковое представление value в формате валюты. Если указан symbol, используется он, вместо символа валюты по умолчанию. Если указана precision, используется для установки точности значения валюты.

Этот метод был представлен в Qt 5.7.

См. также currencySymbol().

QString QLocale::toCurrencyString(float i, const QString &symbol = QString(), int precision = -1) const

Этот метод перегружает toCurrencyString().

QDate QLocale::toDate(const QString &string, QLocale::FormatType format = LongFormat) const

Парсит строку даты, заданную в string, и возвращает дату. Формат строки даты выбирается в соответствии с параметром format (см. dateFormat()).

Если дата не может быть обработана, возвращается недействительная дата.

См. также dateFormat(), toTime(), toDateTime(), и QDate::fromString().

QDate QLocale::toDate(const QString &string, const QString &format) const

Парсит строку даты, заданную в string, и возвращает дату. См. QDate::fromString() для информации об выражениях, которые могут быть использованы с этой функцией.

Эта функция ищет названия месяцев и дней недели в текущей локали.

Если дата не может быть обработана, возвращается недействительная дата.

См. также dateFormat(), toTime(), toDateTime(), и QDate::fromString().

[since 5.14] QDate QLocale::toDate(const QString &string, QLocale::FormatType format, QCalendar cal) const

Это перегруженный метод.

Этот метод был представлен в Qt 5.14.

[since 5.14] QDate QLocale::toDate(const QString &string, const QString &format, QCalendar cal) const

Это перегруженный метод.

Этот метод был представлен в Qt 5.14.

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format = LongFormat) const

Парсит строку даты/времени, заданную в string, и возвращает время. Формат строки даты/времени выбирается в соответствии с параметром format (см. dateTimeFormat()).

Если строка не может быть обработана, возвращается недействительная QDateTime.

См. также dateTimeFormat(), toTime(), toDate(), и QDateTime::fromString().

QDateTime QLocale::toDateTime(const QString &string, const QString &format) const

Парсит строку даты/времени, заданную в string, и возвращает время. См. QDateTime::fromString() для информации об выражениях, которые могут быть использованы с этой функцией.

Если строка не может быть обработана, возвращается недействительная QDateTime. Если строка может быть обработана и представляет недействительную дату-время (например, в промежутке, пропущенном из-за изменения часового пояса), возвращается недействительная QDateTime, чье toMSecsSinceEpoch() представляет близкую дату-время, которая является действительной. Передача ее в fromMSecsSinceEpoch() приведет к получению действительной даты-времени, которая не является точно представленной обработанной строкой.

См. также dateTimeFormat(), toTime(), toDate(), и QDateTime::fromString().

[since 5.14] QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format, QCalendar cal) const

Это перегруженный метод.

Этот метод был представлен в Qt 5.14.

[since 5.14] QDateTime QLocale::toDateTime(const QString &string, const QString &format, QCalendar cal) const

Это перегруженный метод.

Этот метод был представлен в Qt 5.14.

double QLocale::toDouble(const QString &s, bool *ok = nullptr) const

Возвращает double, представленный локализованной строкой s.

Возвращает бесконечность, если преобразование переполняет, или 0.0, если преобразование завершается неудачей по любой другой причине (например, недополнение).

Если ok не nullptr, ошибка сообщается путем установки *ok в false, а успех путем установки *ok в true.

Эта функция не использует локаль 'C', если строка не может быть интерпретирована в данной локали.

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble("1234.56", &ok);  // ok == true,  d == 1234.56
d = c.toDouble("1,234.56", &ok); // ok == true,  d == 1234.56
d = c.toDouble("1234,56", &ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble("1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble("1.234,56", &ok); // ok == true,  d == 1234.56
d = german.toDouble("1234.56", &ok);  // ok == false, d == 0

d = german.toDouble("1.234", &ok);    // ok == true,  d == 1234.0

Обратите внимание, что последнее преобразование возвращает 1234.0, потому что '.' является разделителем тысяч в немецкой локали.

Эта функция игнорирует ведущие и хвостовые пробелы.

См. также toFloat(), toInt(), и toString().

[since 5.10] double QLocale::toDouble(QStringView s, bool *ok = nullptr) const

Возвращает double, представленный локализованной строкой s.

Возвращает бесконечность, если преобразование переполняет, или 0.0, если преобразование завершается неудачей по любой другой причине (например, недополнение).

Если ok не nullptr, ошибка сообщается путем установки *ok в false, а успех путем установки *ok в true.

В отличие от QString::toDouble(), эта функция не использует локаль "C", если строка не может быть интерпретирована в данной локали.

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble(u"1234.56", &ok);  // ok == true,  d == 1234.56
d = c.toDouble(u"1,234.56", &ok); // ok == true,  d == 1234.56
d = c.toDouble(u"1234,56", &ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble(u"1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble(u"1.234,56", &ok); // ok == true,  d == 1234.56
d = german.toDouble(u"1234.56", &ok);  // ok == false, d == 0

d = german.toDouble(u"1.234", &ok);    // ok == true,  d == 1234.0

Обратите внимание, что последнее преобразование возвращает 1234.0, потому что '.' является разделителем тысяч в немецкой локали.

Эта функция игнорирует ведущие и хвостовые пробелы.

Этот метод был представлен в Qt 5.10.

См. также toFloat(), toInt(), и toString().

float QLocale::toFloat(const QString &s, bool *ok = nullptr) const

Возвращает float, представленный локализованной строкой s.

Возвращает бесконечность, если преобразование переполняет, или 0.0, если преобразование завершается неудачей по любой другой причине (например, недополнение).

Если ok не nullptr, ошибка сообщается путем установки *ok в false, а успех путем установки *ok в true.

Эта функция не использует локаль 'C', если строка не может быть интерпретирована в данной локали.

Эта функция игнорирует ведущие и хвостовые пробелы.

См. также toDouble(), toInt(), и toString().

[since 5.10] float QLocale::toFloat(QStringView s, bool *ok = nullptr) const

Возвращает float, представленный локализованной строкой s.

Возвращает бесконечность, если преобразование переполняет, или 0.0, если преобразование завершается неудачей по любой другой причине (например, недополнение).

Если ok не nullptr, ошибка сообщается путем установки *ok в false, а успех путем установки *ok в true.

Эта функция игнорирует ведущие и хвостовые пробелы.

Этот метод был представлен в Qt 5.10.

См. также toDouble(), toInt() и toString().

int QLocale::toInt(const QString &s, bool *ok = nullptr) const

Возвращает целое число int, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Функция игнорирует начальные и конечные пробелы.

См. также toUInt() и toString().

[since 5.10] int QLocale::toInt(QStringView s, bool *ok = nullptr) const

Возвращает целое число int, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.10.

См. также toUInt() и toString().

[since 5.13] long QLocale::toLong(const QString &s, bool *ok = nullptr) const

Возвращает целое число long, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.13.

См. также toInt(), toULong(), toDouble() и toString().

[since 5.13] long QLocale::toLong(QStringView s, bool *ok = nullptr) const

Возвращает целое число long, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.13.

См. также toInt(), toULong(), toDouble() и toString().

qlonglong QLocale::toLongLong(const QString &s, bool *ok = nullptr) const

Возвращает целое число long long, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Функция игнорирует начальные и конечные пробелы.

См. также toInt(), toULongLong(), toDouble() и toString().

[since 5.10] qlonglong QLocale::toLongLong(QStringView s, bool *ok = nullptr) const

Возвращает целое число long long, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.10.

См. также toInt(), toULongLong(), toDouble(), и toString().

QString QLocale::toLower(const QString &str) const

Возвращает копию str в нижнем регистре.

Если Qt Core использует библиотеки ICU, они будут использоваться для выполнения преобразования в соответствии с правилами текущей локали. В противном случае преобразование может выполняться платформозависимым способом, с QString::toLower() в качестве универсального резервного варианта.

См. также QString::toLower().

short QLocale::toShort(const QString &s, bool *ok = nullptr) const

Возвращает целое число short, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Функция игнорирует начальные и конечные пробелы.

См. также toUShort() и toString().

[since 5.10] short QLocale::toShort(QStringView s, bool *ok = nullptr) const

Возвращает целое число short, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.10.

См. также toUShort() и toString().

QString QLocale::toString(qlonglong i) const

Возвращает локализованное строковое представление i.

См. также toLongLong(), numberOptions(), zeroDigit() и positiveSign().

QString QLocale::toString(qulonglong i) const

Это перегруженная функция.

См. также toULongLong(), numberOptions(), zeroDigit() и positiveSign().

QString QLocale::toString(long i) const

Это перегруженная функция.

См. также toLong().

QString QLocale::toString(ulong i) const

Это перегруженная функция.

См. также toULong().

QString QLocale::toString(short i) const

Это перегруженная функция.

См. также toShort().

QString QLocale::toString(ushort i) const

Это перегруженная функция.

См. также toUShort().

QString QLocale::toString(int i) const

Это перегруженная функция.

См. также toInt().

QString QLocale::toString(uint i) const

Это перегруженная функция.

См. также toUInt().

QString QLocale::toString(double f, char format = 'g', int precision = 6) const

Это перегруженная функция.

Возвращает строку, представляющую дробное число f.

Форма представления контролируется параметрами format и precision.

format по умолчанию 'g'. Он может быть любым из следующих:

Для форматов 'e', 'E', и 'f', точность представляет количество цифр после десятичной точки. Для форматов 'g' и 'G', точность представляет максимальное количество значащих цифр (завершающие нули опускаются). Специальное значение точности QLocale::FloatingPointShortest выбирает самое короткое представление, которое, при чтении как число, возвращает исходное значение с плавающей точкой. Помимо этого, любая отрицательная точность игнорируется в пользу значения по умолчанию, равного 6.

Для форматов 'e', 'f' и 'g', положительная бесконечность представлена как "inf", отрицательная бесконечность как "-inf", а значения с плавающей точкой NaN (not-a-number) представлены как "nan". Для форматов 'E' и 'G' используются "INF" и "NAN" соответственно. Это не зависит от локали.

См. также toDouble(), numberOptions(), exponential(), decimalPoint(), zeroDigit(), positiveSign(), percent(), toCurrencyString(), formattedDataSize(), и QLocale::FloatingPointPrecisionOption.

QString QLocale::toString(float f, char format = 'g', int precision = 6) const

Это перегруженная функция.

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

Формат и точность имеют то же значение, что и описано в toString(double, char, int).

См. также toFloat(), toDouble(), numberOptions(), exponential(), decimalPoint(), zeroDigit(), positiveSign(), percent(), toCurrencyString(), formattedDataSize(), и QLocale::FloatingPointPrecisionOption.

QString QLocale::toString(QDate date, const QString &format) const

Возвращает локализованное строковое представление заданной даты date в указанном формате. Если формат пустая строка, возвращается пустая строка.

См. также QDate::toString().

QString QLocale::toString(QTime time, const QString &format) const

Возвращает локализованное строковое представление заданного времени time в соответствии с указанным форматом. Если формат пустая строка, возвращается пустая строка.

См. также QTime::toString().

QString QLocale::toString(const QDateTime &dateTime, const QString &format) const

Возвращает локализованное строковое представление заданной dateTime в соответствии с указанным форматом. Если формат пустая строка, возвращается пустая строка.

См. также QDateTime::toString(), QDate::toString(), и QTime::toString().

[since 5.10] QString QLocale::toString(QDate date, QStringView format) const

Это перегруженная функция.

Эта функция была добавлена в Qt 5.10.

QString QLocale::toString(QTime time, QStringView format) const

Возвращает локализованное строковое представление заданного времени time в соответствии с указанным форматом. Если формат пустая строка, возвращается пустая строка.

См. также QTime::toString().

[since 5.10] QString QLocale::toString(const QDateTime &dateTime, QStringView format) const

Это перегруженная функция.

Эта функция была добавлена в Qt 5.10.

QString QLocale::toString(QDate date, QLocale::FormatType format = LongFormat) const

Это перегруженная функция.

QString QLocale::toString(QTime time, QLocale::FormatType format = LongFormat) const

Возвращает локализованное строковое представление заданного времени time в указанном формате (см. timeFormat()).

QString QLocale::toString(const QDateTime &dateTime, QLocale::FormatType format = LongFormat) const

Это перегруженная функция.

[since 5.14] QString QLocale::toString(QDate date, QStringView format, QCalendar cal) const

Возвращает локализованное строковое представление заданной даты date в указанном формате, необязательно для указанного календаря cal. Если формат пустая строка, возвращается пустая строка.

Эта функция была добавлена в Qt 5.14.

См. также QDate::toString().

[since 5.14] QString QLocale::toString(QDate date, QLocale::FormatType format, QCalendar cal) const

Возвращает локализованное строковое представление заданной даты date в соответствии с указанным форматом (см. dateFormat()), необязательно для указанного календаря cal.

Эта функция была добавлена в Qt 5.14.

[since 5.14] QString QLocale::toString(const QDateTime &dateTime, QLocale::FormatType format, QCalendar cal) const

Возвращает локализованное строковое представление заданной dateTime в соответствии с указанным форматом (см. dateTimeFormat()), необязательно для указанного календаря cal.

Эта функция была добавлена в Qt 5.14.

[since 5.14] QString QLocale::toString(const QDateTime &dateTime, QStringView format, QCalendar cal) const

Возвращает локализованное строковое представление заданной dateTime в соответствии с указанным форматом, необязательно для указанного календаря cal. Если формат пустая строка, возвращается пустая строка.

Эта функция была добавлена в Qt 5.14.

См. также QDateTime::toString(), QDate::toString(), и QTime::toString().

QTime QLocale::toTime(const QString &string, QLocale::FormatType format = LongFormat) const

Парсит строку времени, заданную в string, и возвращает время. Формат строки времени выбирается в соответствии с параметром формат (см. timeFormat()).

Если время не удалось разобрать, возвращается недействительное время.

См. также timeFormat(), toDate(), toDateTime(), и QTime::fromString().

QTime QLocale::toTime(const QString &string, const QString &format) const

Парсит строку времени, заданную в string, и возвращает время. См. QTime::fromString() для информации о допустимом формате строки.

Если время не удалось разобрать, возвращается недействительное время.

См. также timeFormat(), toDate(), toDateTime(), и QTime::fromString().

uint QLocale::toUInt(const QString &s, bool *ok = nullptr) const

Возвращает целое беззнаковое число типа int, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в true.

Эта функция игнорирует начальные и конечные пробелы.

См. также toInt() и toString().

[since 5.10] uint QLocale::toUInt(QStringView s, bool *ok = nullptr) const

Возвращает целое беззнаковое число типа int, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в true.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.10.

См. также toInt() и toString().

[since 5.13] ulong QLocale::toULong(const QString &s, bool *ok = nullptr) const

Возвращает целое беззнаковое число типа long, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в true.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.13.

См. также toLong(), toInt(), toDouble(), и toString().

[since 5.13] ulong QLocale::toULong(QStringView s, bool *ok = nullptr) const

Возвращает целое беззнаковое число типа long, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в true.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.13.

См. также toLong(), toInt(), toDouble(), и toString().

qulonglong QLocale::toULongLong(const QString &s, bool *ok = nullptr) const

Возвращает целое беззнаковое число типа long long, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в true.

Эта функция игнорирует начальные и конечные пробелы.

См. также toLongLong(), toInt(), toDouble(), и toString().

[since 5.10] qulonglong QLocale::toULongLong(QStringView s, bool *ok = nullptr) const

Возвращает целое беззнаковое число типа long long, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в true.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.10.

См. также toLongLong(), toInt(), toDouble(), и toString().

ushort QLocale::toUShort(const QString &s, bool *ok = nullptr) const

Возвращает целое беззнаковое число типа short, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в true.

Эта функция игнорирует начальные и конечные пробелы.

См. также toShort() и toString().

[since 5.10] ushort QLocale::toUShort(QStringView s, bool *ok = nullptr) const

Возвращает целое беззнаковое число типа short, представленное локализованной строкой s.

Если преобразование завершается неудачно, функция возвращает 0.

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в true.

Эта функция игнорирует начальные и конечные пробелы.

Эта функция была добавлена в Qt 5.10.

См. также toShort() и toString().

QString QLocale::toUpper(const QString &str) const

Возвращает копию str в верхнем регистре.

Если Qt Core использует библиотеки ICU, они будут использованы для преобразования в соответствии с правилами текущей локали. В противном случае преобразование может выполняться платформозависимым способом, с QString::toUpper() в качестве универсального резервного варианта.

См. также QString::toUpper().

QStringList QLocale::uiLanguages() const

Возвращает упорядоченный список имен локалей для целей перевода в порядке предпочтения (например, "en-Latn-US", "en-US", "en").

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

Скорее всего, вам не нужно использовать эту функцию напрямую, а просто передать объект QLocale функции QTranslator::load().