Класс QLocale

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

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

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

• setDefault(const QLocale &locale)

Публичные типы

Публичные функции

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

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

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

QLocale инициализируется парой язык/страна в конструкторе и предоставляет функции преобразования чисел в строки и строк в числа, аналогичные функциям в QString.

Пример:

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::toInt(), QString::toDouble() и т.д. интерпретируют строку в соответствии с системной локалью. Если это не удается, используется локаль "C".
• QString::arg() использует системную локаль для форматирования числа, когда его спецификатор в строке формата содержит 'L', например, "%L1".

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

QLocale::setDefault(QLocale(QLocale::Hebrew, QLocale::Israel));
QLocale hebrew; // Constructs a default QLocale
QString s1 = hebrew.toString(15714.3, 'e');

bool ok;
double d;

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

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

QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
QString str = QString("%1 %L2 %L3")
      .arg(12345).arg(12345).arg(12345, 0, 16);
// str == "12345 12,345 3039"

Когда пара язык/страна задается в конструкторе, может произойти одно из трех:

• Если пара язык/страна найдена в базе данных, она используется.
• Если язык найден, а страна нет, или если страна AnyCountry, язык используется с наиболее подходящей доступной страной (например, Германия для немецкого языка).
• Если ни язык, ни страна не найдены, QLocale по умолчанию использует системную локаль (см. setDefault()).

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

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

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

Этот конструктор преобразует имя локали в пару язык/страна; он не использует базу данных системной локали.

Примечание: Для текущей локали ввода клавиатуры обратитесь к QInputMethod::locale().

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

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

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

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

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

См. также country() и countryToString().

enum QLocale::CurrencySymbolFormat

Определяет формат знака валюты.

[since 5.10] enum QLocale::DataSizeFormatфлаги QLocale::DataSizeFormats

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

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

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

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

[since 5.7] enum QLocale::FloatingPointPrecisionOption

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

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

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

enum QLocale::FormatType

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

Примечание: NarrowFormat может содержать один и тот же текст для разных месяцев и дней. Он даже может быть пустой строкой, если в локале не поддерживаются узкие имена, поэтому следует избегать его использования для форматирования дат. Кроме того, для системной локали этот формат такой же, как ShortFormat.

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

enum QLocale::Language

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

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

enum QLocale::MeasurementSystem

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

enum QLocale::NumberOptionflags QLocale::NumberOptions

Этот перечисление определяет набор параметров для преобразования чисел в строки и строк в числа. Они могут быть получены с помощью numberOptions() и установлены с помощью setNumberOptions().

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

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

enum QLocale::QuotationStyle

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

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

enum QLocale::Script

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

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

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

QLocale::QLocale(const QLocale &other)

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

QLocale::QLocale(QLocale::Language language, QLocale::Script script, QLocale::Country country)

Создаёт объект QLocale со значениями language, script и country.

• Если язык/написание/страна найдены в базе данных, используется это значение.
• Если script равен AnyScript и country равен AnyCountry, используется язык с наиболее подходящим доступным написанием и страной (например, Германия для немецкого языка).
• Если либо script равен AnyScript, либо country равен AnyCountry, используется первый локализованный объект, соответствующий заданному script и country.
• Если ни язык, ни страна не найдены, QLocale по умолчанию использует локаль по умолчанию (см. setDefault()).

Используемые язык, написание и страна могут быть получены с помощью language(), script() и country().

См. также setDefault(), language(), script() и country().

QLocale::QLocale(QLocale::Language language, QLocale::Country country = AnyCountry)

Создаёт объект QLocale со значениями language и country.

• Если пара язык/страна найдена в базе данных, используется это значение.
• Если язык найден, а страна — нет, или страна равна AnyCountry, используется язык с наиболее подходящей доступной страной (например, Германия для немецкого языка).
• Если ни язык, ни страна не найдены, QLocale по умолчанию использует локаль по умолчанию (см. setDefault()).

Используемые язык и страна могут быть получены с помощью language() и country().

См. также setDefault(), language() и country().

QLocale::QLocale(const QString &name)

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

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

Разделителем может быть либо нижнее подчёркивание '_' (U+005F), либо дефис '-' (U+002D).

Если строка не соответствует формату локали, или язык не является допустимым кодом ISO 639, используется локаль "C". Если страна отсутствует или не является допустимым кодом ISO 3166, для указанного языка выбирается наиболее подходящая страна.

Коды языка, написания и страны преобразуются в соответствующие перечисления Language, Script и Country. После этого преобразования конструктор ведет себя точно так же, как QLocale(Country, Script, Language).

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

См. также 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(), country(), script() и uiLanguages().

QLocale QLocale::c()

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

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

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

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

QLocale::Country QLocale::codeToCountry(QStringView countryCode)

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

Если код недействителен или неизвестен, возвращается QLocale::AnyCountry.

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

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

QLocale::Language QLocale::codeToLanguage(QStringView languageCode)

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

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

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

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

QLocale::Script QLocale::codeToScript(QStringView scriptCode)

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

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

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

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

QLocale QLocale::collation() const

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

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

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

См. также QCollator.

QLocale::Country QLocale::country() const

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

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

QString QLocale::countryToCode(QLocale::Country country)

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

Примечание: Для QLocale::AnyCountry возвращается пустая строка.

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

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

[static] QString QLocale::countryToString(QLocale::Country country)

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

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

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

Возвращает локальное имя дня недели (где 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-стандарты (k, M и т. д.), а DataSizeTraditionalFormat использует их ненадлежащим образом.

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

QString QLocale::groupSeparator() const

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

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

QLocale::Language QLocale::language() const

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

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

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

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

Примечание: Для QLocale::C функция возвращает "C". Для QLocale::AnyLanguage возвращается пустая строка.

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

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

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

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

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

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

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

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

Получение списка локалей, подходящих для России: 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 был создан с явным скриптом, name() не будет его содержать по соображениям совместимости. Используйте bcp47Name() вместо этого, если вам нужен полный идентификатор локали.

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

QString QLocale::nativeCountryName() const

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

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

QString QLocale::nativeLanguageName() const

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

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

QString QLocale::negativeSign() const

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

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

QLocale::NumberOptions QLocale::numberOptions() const

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

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

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

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

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

См. также язык(), страна(), languageToString(), scriptToString(), и bcp47Name().

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

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

Примечание: Для QLocale::AnyScript возвращается пустая строка.

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

См. также написание(), name(), bcp47Name(), languageToCode() и countryToCode().

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

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

См. также languageToString(), countryToString(), написание(), и bcp47Name().

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

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

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

Предупреждение: Эта функция не реентерабельна.

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

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

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

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

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, инициализированный системной локалью.

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

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

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

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

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

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в 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

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

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

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в 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

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

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

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

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

Этот метод игнорирует начальные и конечные пробелы.

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

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

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

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

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

Этот метод игнорирует начальные и конечные пробелы.

Этот метод был введён в Qt 5.10.

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

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

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

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

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

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

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

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

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

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

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в 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, а успех — в 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, а успех — в 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, а успех — в 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, а успех — в 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, а успех — в true.

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

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

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

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

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

Если ok не nullptr, неудача сообщается установкой *ok в false, а успех — в 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 i, char f = 'g', int prec = 6) const

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

f и prec имеют то же значение, что и в QString::number(double, char, int).

См. также toDouble(), numberOptions(), exponential(), decimalPoint(), zeroDigit(), positiveSign() и percent().

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

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

f и prec имеют то же значение, что и в QString::number(double, char, int).

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

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

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

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

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

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

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

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

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

См. также 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 в соответствии с указанным форматом format. Если format пустая строка, возвращается пустая строка.

См. также 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. Если format пустая строка, возвращается пустая строка.

Этот метод был добавлен в 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. Если format пустая строка, возвращается пустая строка.

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

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

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

Парсит строку времени, заданную в string, и возвращает время. Формат строки времени выбирается в соответствии с параметром format (см. 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

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

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

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

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

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

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

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

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

Если ok не nullptr, ошибка сообщается путем задания *ok в false, а успех — путем задания *ok в 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, а успех — путем задания *ok в 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, а успех — путем задания *ok в true.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в 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().

Первый элемент в списке является наиболее предпочтительным.

См. также QTranslator и bcp47Name().

QList<Qt::DayOfWeek> QLocale::weekdays() const

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

QString QLocale::zeroDigit() const

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

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