Класс 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 = QString("1234.56").toDouble(&ok);   // ok == true, d == 1234.56

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

QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
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 v36.

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

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

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

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

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

enum QLocale::CurrencySymbolFormat

Указывает формат знака валюты.

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

enum QLocale::DataSizeFormatflags QLocale::DataSizeFormats

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

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

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

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

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

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

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

enum QLocale::NumberOptionflags QLocale::NumberOptions

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

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

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

enum QLocale::QuotationStyle

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

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

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

enum QLocale::Script

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

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

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

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

QLocale::QLocale(const QLocale &other)

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

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

Создаёт объект QLocale с указанным языком, написанием и страной.

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

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

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

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

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

Создаёт объект QLocale с указанным языком и страной.

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

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

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

QLocale::QLocale(const QString &name)

Создаёт объект QLocale с указанным именем, которое имеет формат "language[_script][_country][.codeset][@modifier]" или "C", где:

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

Разделитель может быть либо нижним подчеркиванием, либо дефисом.

Если строка нарушает формат локали или язык не является допустимым кодом 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-часового формата.

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

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

QString QLocale::bcp47Name() const

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

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

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

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

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

QLocale QLocale::c()

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

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

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

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

QLocale QLocale::collation() const

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

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

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

См. также QCollator.

QLocale::Country QLocale::country() const

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

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

QString QLocale::countryToString(QLocale::Country country)

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

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

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

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

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

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

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

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

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

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

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

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

См. также 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.

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

См. также 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.

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

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

QChar QLocale::decimalPoint() const

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для преобразования заранее.

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

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

QChar QLocale::exponential() const

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для преобразования заранее.

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

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

Qt::DayOfWeek QLocale::firstDayOfWeek() const

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

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

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

Преобразует размер в байтах в локализованную строку, удобочитаемую для человека, включающую число и единицу измерения. Кратность выбирается таким образом, чтобы число было не меньше единицы и максимально малым. Например, если bytes равно 16384, precision равно 2, а format равен DataSizeIecFormat (по умолчанию), эта функция возвращает "16.00 KiB"; для 1330409069609 байт — "1.21 GiB" и так далее. Если format равен DataSizeIecFormat или DataSizeTraditionalFormat, заданное количество байтов делится на степень 1024, с результатом меньше 1024; для DataSizeSIFormat — на степень 1000, с результатом меньше 1000. DataSizeIecFormat использует новые обозначения IEC (Ki, Mi и т. д.), а DataSizeSIFormat — старые SI (k, M и т. д.), и DataSizeTraditionalFormat их использует неправильно.

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

QChar QLocale::groupSeparator() const

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для преобразования заранее.

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

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

QLocale::Language QLocale::language() const

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

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

QString QLocale::languageToString(QLocale::Language language)

Возвращает QString с именем language.

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

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);

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

QLocale::MeasurementSystem QLocale::measurementSystem() const

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

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

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

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

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

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

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

QString QLocale::name() const

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

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

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

QString QLocale::nativeCountryName() const

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

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

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

QString QLocale::nativeLanguageName() const

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

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

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

QChar QLocale::negativeSign() const

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для преобразования заранее.

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

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

QLocale::NumberOptions QLocale::numberOptions() const

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

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

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

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

QChar QLocale::percent() const

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для раннего преобразования.

Функция была добавлена в Qt 4.1.

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

QString QLocale::pmText() const

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

Функция была добавлена в Qt 4.5.

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

QChar QLocale::positiveSign() const

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

Примечание: В Qt6 эта функция будет возвращать QString вместо QChar. Рекомендуется использовать конструктор QString(QChar) для раннего преобразования.

Функция была добавлена в Qt 4.5.

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

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

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

Функция была добавлена в Qt 4.8.

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

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

Функция была добавлена в Qt 4.8.

QLocale::Script QLocale::script() const

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

Функция была добавлена в Qt 4.8.

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

QString QLocale::scriptToString(QLocale::Script script)

Возвращает QString с названием типа письма script.

Функция была добавлена в Qt 4.8.

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

void QLocale::setDefault(const QLocale &locale)

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

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

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

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

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

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

Функция была добавлена в Qt 4.2.

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

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

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

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

Функция была добавлена в Qt 4.5.

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

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

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

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

Функция была добавлена в Qt 4.5.

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

void QLocale::swap(QLocale &other)

Меняет местами языковые настройки other и текущего объекта. Эта операция очень быстрая и никогда не завершается с ошибкой.

Функция была добавлена в Qt 5.6.

QLocale QLocale::system()

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

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

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

Qt::LayoutDirection QLocale::textDirection() const

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

Функция была добавлена в Qt 4.7.

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

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

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

Функция была добавлена в Qt 4.1.

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

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

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

Функция была добавлена в Qt 4.8.

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

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

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

Функция была добавлена в Qt 4.8.

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

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

Функция была добавлена в Qt 4.8.

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

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

Функция была добавлена в Qt 4.8.

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

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

Функция была добавлена в Qt 4.8.

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

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

Функция была добавлена в Qt 4.8.

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

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

Функция была добавлена в Qt 4.8.

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

Это перегрузка функции toCurrencyString().

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

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

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

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

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

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

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

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

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

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

Функция ищет названия месяцев и дней недели в текущем языке.

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

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

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

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

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

Эта функция была добавлена в Qt 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.

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

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

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

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

Примечание: Имена месяцев и дней должны быть заданы на языке пользователя.

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

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

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

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

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

Эта функция была добавлена в Qt 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 не задан, ошибка сообщается, устанавливая *ok в nullptr, а успех — устанавливая *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

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 = german.toDouble( "1.234", &ok );    // ok == true, d == 1234.0

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

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

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

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

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

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

Если ok не задан, ошибка сообщается, устанавливая *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

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 = german.toDouble( "1.234", &ok );    // ok == true, d == 1234.0

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

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

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

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

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

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

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

В отличие от 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

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

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

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

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

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

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

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

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

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

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

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

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().

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

long QLocale::toLong(const QStringRef &s, bool *ok = nullptr) const

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

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

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

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

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

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

long QLocale::toLong(QStringView s, bool *ok = nullptr) const

Возвращает целое число long int, представленное локализованной строкой 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 int, представленное локализованной строкой s.

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает целое число long long int, представленное локализованной строкой 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() в качестве универсального резервного варианта.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает целое число short int, представленное локализованной строкой 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 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(const QDate &date, const QString &format) const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает локализованную строковую форму данного date по указанному format (см. dateFormat()).

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

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

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

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

Возвращает локализованную строковую форму данного dateTime по указанному format (см. dateTimeFormat()).

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

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

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

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

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

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

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

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

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

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

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

См. также 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().

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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().

ulong QLocale::toULong(const QStringRef &s, bool *ok = nullptr) const

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

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

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

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

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

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

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().