QLocale Class

Dokumentation zu den Mitgliedsfunktionen

QLocale::QLocale()

Erstellt ein QLocale-Objekt, das mit der Standard-Locale initialisiert ist.

Wenn mit ` setDefault()` keine Standard-Locale festgelegt wurde, entspricht diese Locale derjenigen, die von ` system()` zurückgegeben wird.

Siehe auch setDefault() und system().

[explicit, since 6.3] QLocale::QLocale(QStringView name)

Erstellt ein QLocale-Objekt mit der angegebenen „ name “.

Der Name hat das Format „language[_script][_territory][.codeset][@modifier]“ oder „C“, wobei:

• „language“ ein aus zwei Kleinbuchstaben bestehender ISO-639-Sprachcode ist (einige dreistellige Codes werden ebenfalls erkannt),
• „script“ ein vierbuchstabiger, großgeschriebener ISO-15924-Schriftsystemcode ist,
• „territory“ ein aus zwei Großbuchstaben bestehender ISO-3166-Gebietscode ist (einige numerische Codes werden ebenfalls erkannt) und
• „codeset“ und „modifier“ werden ignoriert.

Als Trennzeichen kann entweder der Unterstrich '_' (U+005F, „Unterstrich“) oder der Bindestrich '-' (U+002D, „Bindestrich-Minus“) verwendet werden. Wenn QLocale keine Daten für die angegebene Kombination aus Sprache, Schrift und Gebiet hat, verwendet es stattdessen die am besten passende Übereinstimmung, die es finden kann. Wenn die Zeichenkette gegen das Locale-Format verstößt oder keine passenden Daten für die angegebenen Schlüssel gefunden werden können, wird stattdessen die Locale „C“ verwendet.

Dieser Konstruktor ist wesentlich langsamer als QLocale(Language, Script, Territory) oder QLocale(Language, Territory).

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch bcp47Name() und Matching combinations of language, script and territory.

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

Erstellt ein QLocale-Objekt für die angegebenen Werte „ language “ und „ territory “.

Wenn für diese Kombination mehr als ein Skript verwendet wird, wird ein passendes Skript ausgewählt. Wenn QLocale keine Daten für die angegebene „ language “ enthält, wird die Standard-Locale verwendet. Wenn QLocale keine Daten für die angegebene Kombination aus „ language “ und „ territory “ enthält, kann stattdessen ein alternatives Gebiet verwendet werden.

Siehe auch setDefault() und Matching combinations of language, script and territory.

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

Erstellt ein QLocale-Objekt für die angegebenen Werte „ language “, „ script “ und „ territory “.

Wenn QLocale keine Daten für die angegebene Kombination enthält, sucht es nach Daten, die so gut wie möglich passen. Es greift auf die Standard-Locale zurück, wenn

• language AnyLanguage ist und aus keine Sprache abgeleitet werden kann und script territory
• QLocale keine Daten für die Sprache hat, sei es als „ language “ angegeben oder wie oben abgeleitet.

Siehe auch setDefault() und Matching combinations of language, script and territory.

[explicit] QLocale::QLocale(const QString &name)

[noexcept] QLocale::QLocale(const QLocale &other)

Erstellt ein QLocale-Objekt als Kopie von ` other`.

[noexcept] QLocale::~QLocale()

Destruktor

QString QLocale::amText() const

Gibt den lokalisierten Namen des Suffixes „AM“ für Zeiten zurück, die gemäß den Konventionen der 12-Stunden-Uhr angegeben wurden.

Siehe auch pmText().

QString QLocale::bcp47Name(QLocale::TagSeparator separator = TagSeparator::Dash) const

Gibt die BCP47-Feldnamen durch Bindestriche verbunden zurück.

Dabei werden so viele Felder aus den Bereichen „Sprache“, „Schrift“ und „Gebiet“ (sowie gegebenenfalls weitere BCP47-Felder) für diese Locale kombiniert, wie zur eindeutigen Spezifizierung erforderlich sind. Beachten Sie, dass Felder weggelassen werden können, wenn die „ Likely Subtag Rules “ des Unicode-Konsortiums die weggelassenen Felder implizieren, sobald die beibehaltenen Felder angegeben werden. Informationen dazu, wie aus einzelnen Feldern eine Zeichenkette gebildet werden kann, falls ein anderes Format benötigt wird, finden Sie unter name().

Im Gegensatz zu uiLanguages() stellt der von bcp47Name() zurückgegebene Wert den Locale-Namen der Daten aus QLocale dar; dies muss nicht unbedingt die Sprache sein, in der die Benutzeroberfläche angezeigt werden soll.

Diese Funktion versucht, den Locale-Namen an die IETF Best Common Practice 47 anzupassen, die in RFC 5646 definiert ist. Seit Qt 6.7 unterstützt sie einen optionalen Parameter ` separator `, mit dem die in BCP47 festgelegte Verwendung eines Bindestrichs zur Trennung der Tags überschrieben werden kann. Für die Verwendung in von der IETF definierten Protokollen sollte jedoch die Standardeinstellung „ QLocale::TagSeparator::Dash “ beibehalten werden.

Siehe auch name(), language(), territory(), script() und uiLanguages().

[static noexcept] QLocale QLocale::c()

Gibt ein „ QLocale “-Objekt zurück, das auf die Locale „C“ initialisiert ist.

Diese Locale basiert auf „en_US“, weist jedoch einige Eigenheiten auf, wie beispielsweise eine vereinfachte Zahlenformatierung und eine eigene Datumsformatierung. Sie implementiert die POSIX-Standards, die das Verhalten der Standardbibliotheksfunktionen der Programmiersprache „C“ beschreiben.

Das bedeutet unter anderem, dass die Sortierreihenfolge auf den ASCII-Werten der Buchstaben basiert, sodass (bei der Groß-/Kleinschreibung-sensitiven Sortierung) alle Großbuchstaben vor allen Kleinbuchstaben sortiert werden (anstatt dass die Groß- und Kleinbuchstabenformen eines Buchstabens nebeneinander sortiert werden, bevor die beiden Formen des nächsten Buchstabens folgen).

Siehe auch ` system()`.

[static noexcept, since 6.3] QLocale::Language QLocale::codeToLanguage(QStringView languageCode, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

Gibt die Enumeration „ QLocale::Language “ zurück, die dem zwei- oder dreistelligen Code „ languageCode “ entspricht, wie in den ISO 639-Normen definiert.

Falls angegeben, legt „ codeTypes “ fest, welche Codes für die Konvertierung berücksichtigt werden sollen. Standardmäßig werden alle Qt bekannten Codes berücksichtigt. Die Codes werden in der folgenden Reihenfolge abgeglichen: „ ISO639Part1 “, „ ISO639Part2B “, „ ISO639Part2T “, „ ISO639Part3 “, „ LegacyLanguageCode “.

Ist der Code ungültig oder unbekannt, wird „ QLocale::AnyLanguage “ zurückgegeben.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch languageToCode(), codeToTerritory() und codeToScript().

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

Gibt die Enumeration „ QLocale::Script “ zurück, die der vierstelligen Schriftcode- scriptCode entspricht, wie sie in der Norm ISO 15924 definiert ist.

Ist der Code ungültig oder unbekannt, wird „ QLocale::AnyScript “ zurückgegeben.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch „ scriptToCode()“, „ codeToLanguage()“ und „ codeToTerritory()“.

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

Gibt die Enumeration „ QLocale::Territory “ zurück, die dem zweibuchstabigen oder dreistelligen Ländercode „ territoryCode “ entspricht, wie er im ISO 3166-Standard definiert ist.

Ist der Code ungültig oder unbekannt, wird ` QLocale::AnyTerritory ` zurückgegeben.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch „ territoryToCode()“, „ codeToLanguage()“ und „ codeToScript()“.

QLocale QLocale::collation() const

Gibt die für die Sortierung zu verwendende Locale zurück.

Das Ergebnis ist in der Regel diese Locale; die System-Locale (die üblicherweise die Standard-Locale ist) gibt jedoch die System-Sortier-Locale zurück. Das Ergebnis eignet sich zur Übergabe an den Konstruktor von ` QCollator`.

Siehe auch QCollator.

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

Gibt eine Zeichenkette zurück, die eine Verknüpfung einer vorgegebenen Zeichenkette „ list “ mit einem durch die Locale definierten Trennzeichen darstellt.

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

Gibt ein Währungssymbol gemäß der Norm „ format “ zurück.

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

Gibt das für die aktuelle Ländereinstellung verwendete Datumsformat zurück.

Wenn „ format “ auf „ LongFormat “ gesetzt ist, ist das Format ausführlich, andernfalls ist es kurz. Beispielsweise lautet „ LongFormat “ für die Locale „ en_US “ „ dddd, MMMM d, yyyy “, „ ShortFormat “ lautet „ M/d/yy “.

Siehe auch QDate::toString() und QDate::fromString().

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

Gibt das für die aktuelle Ländereinstellung verwendete Datums- und Zeitformat zurück.

Wenn „ format “ auf „ LongFormat “ gesetzt ist, ist das Format ausführlich, andernfalls ist es kurz. Beispielsweise lautet „ LongFormat “ für die Locale „ en_US “ „ dddd, MMMM d, yyyy h:mm:ss AP t “, „ ShortFormat “ lautet „ M/d/yy h:mm AP “.

Siehe auch QDateTime::toString() und QDateTime::fromString().

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

Gibt den lokalisierten Namen des „ day “ zurück (wobei 1 für Montag, 2 für Dienstag usw. steht), und zwar in dem unter type angegebenen Format.

Wenn beispielsweise die Locale „ en_US “ lautet und „ day “ den Wert 1 hat, gibt „ LongFormat “ „ Monday “ zurück, „ ShortFormat “ „ Mon “ und „ NarrowFormat “ „ M “.

Siehe auch monthName() und standaloneDayName().

QString QLocale::decimalPoint() const

Gibt das Trennzeichen für den Bruchteil dieser Locale zurück.

Dies ist das Zeichen, das in der Darstellung einer Zahl mit Dezimalteil den ganzzahligen Teil vom Dezimalteil trennt. Es wird gemeinhin als „Dezimalpunktzeichen“ bezeichnet – auch wenn es in vielen Locales kein „Punkt“ (oder ähnliches Zeichen) ist. Es wird (seit Qt 6.0) als Zeichenkette zurückgegeben, falls eine Locale mehr als einen UTF-16-Codepunkt benötigt, um ihr Trennzeichen darzustellen.

Siehe auch groupSeparator() und toString().

QString QLocale::exponential() const

Gibt das Exponenten-Trennzeichen für diese Locale zurück.

Dies ist ein Token, das in einigen Darstellungen von Gleitkommazahlen zur Trennung von Mantisse und Exponent verwendet wird. Es wird (seit Qt 6.0) als Zeichenkette zurückgegeben, da es in manchen Locales nicht aus einem einzigen Zeichen besteht – beispielsweise kann es aus einem Multiplikationszeichen und einer Darstellung des Operators „Zehn hoch“ bestehen.

Siehe auch ` toString` (double, char, int).

Qt::DayOfWeek QLocale::firstDayOfWeek() const

Gibt den ersten Wochentag gemäß der aktuellen Ländereinstellung zurück.

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

Wandelt eine Größe in Byte in eine für Menschen lesbare, lokalisierte Zeichenfolge um, die aus einer Zahl und einer quantifizierten Einheit besteht. Der Quantor wird so gewählt, dass die Zahl mindestens eins beträgt und so klein wie möglich ist. Wenn beispielsweise bytes den Wert 16384 hat, precision den Wert 2 und format den Wert DataSizeIecFormat (Standard) angibt, gibt diese Funktion „16,00 KiB“ zurück; für 1330409069609 Byte gibt sie „1,21 GiB“ zurück; und so weiter. Wenn format auf DataSizeIecFormat oder DataSizeTraditionalFormat gesetzt ist, wird die angegebene Anzahl an Bytes durch eine Potenz von 1024 geteilt, wobei das Ergebnis kleiner als 1024 ist; bei DataSizeSIFormat wird sie durch eine Potenz von 1000 geteilt, wobei das Ergebnis kleiner als 1000 ist. DataSizeIecFormat verwendet die neuen IEC-Standardquantoren Ki, Mi usw., während DataSizeSIFormat die älteren SI-Quantoren k, M usw. verwendet und DataSizeTraditionalFormat diese missbraucht.

QString QLocale::groupSeparator() const

Gibt das Trennzeichen für die Zifferngruppierung für diese Ländereinstellung zurück.

Dies ist ein Token, das verwendet wird, um lange Ziffernfolgen in der Darstellung einer Zahl aufzuteilen, um die Lesbarkeit zu verbessern. In einigen Locales kann es leer sein, was bedeutet, dass Ziffern nicht auf diese Weise in Gruppen unterteilt werden sollen. In anderen kann es sich um ein Leerzeichen handeln. Es wird (seit Qt 6.0) als Zeichenkette zurückgegeben, falls eine Locale mehr als einen UTF-16-Codepunkt benötigt, um ihr Trennzeichen darzustellen.

Siehe auch decimalPoint() und toString().

QLocale::Language QLocale::language() const

Gibt die Sprache dieser Locale zurück.

Siehe auch script(), territory(), languageToString() und bcp47Name().

[static, since 6.3] QString QLocale::languageToCode(QLocale::Language language, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

Gibt den zwei- oder dreistelligen Sprachcode für language zurück, wie in den ISO 639-Normen definiert.

Falls angegeben, wählt „ codeTypes “ aus, welcher Satz von Codes berücksichtigt werden soll. Es wird der erste Code aus dem Satz zurückgegeben, der für „ language “ definiert ist. Andernfalls werden alle ISO-639-Codes berücksichtigt. Die Codes werden in der folgenden Reihenfolge berücksichtigt: „ ISO639Part1 “, „ ISO639Part2B “, „ ISO639Part2T “, „ ISO639Part3 “. „ LegacyLanguageCode “ wird von dieser Funktion ignoriert.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch „ codeToLanguage()“, „ language()“, „ name()“, „ bcp47Name()“, „ territoryToCode()“ und „ scriptToCode()“.

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

Gibt ein ` QString ` zurück, das den Namen von ` language` enthält.

Siehe auch territoryToString(), scriptToString() und bcp47Name().

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

Gibt eine Liste gültiger Locale-Objekte zurück, die den angegebenen Werten language, script und territory entsprechen.

Abrufen einer Liste aller Locales: QList<QLocale> allLocales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::AnyTerritory);

Abrufen einer Liste der für Russland geeigneten Locales: QList<QLocale> locales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::Russia);

QLocale::MeasurementSystem QLocale::measurementSystem() const

Gibt das Maßsystem für die Gebietsschemaeinstellung zurück.

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

Gibt den lokalisierten Namen von month im Format zurück, das unter type festgelegt ist.

Wenn beispielsweise die Locale „ en_US “ lautet und „ month “ den Wert 1 hat, gibt „ LongFormat “ „ January “ zurück. „ ShortFormat “ gibt „ Jan “ zurück und „ NarrowFormat “ gibt „ J “ zurück.

Siehe auch dayName() und standaloneMonthName().

QString QLocale::name(QLocale::TagSeparator separator = TagSeparator::Underscore) const

Der Kurzname dieser Locale.

Gibt die Sprache und das Gebiet dieser Locale als Zeichenkette der Form „language_territory“ zurück, wobei „language“ ein zweistelliger ISO-639-Sprachcode in Kleinbuchstaben und „territory“ ein zwei- oder dreistelliger ISO-3166-Gebietscode in Großbuchstaben ist. Wenn für die Locale kein Gebiet angegeben ist, wird nur der Sprachname zurückgegeben. Seit Qt 6.7 kann ein optionaler Parameter ` separator ` übergeben werden, um das standardmäßige Unterstrichzeichen zu überschreiben, das die beiden Tags trennt.

Selbst wenn das ` QLocale `-Objekt mit einem expliziten Skript erstellt wurde, enthält `name()` dieses aus Kompatibilitätsgründen nicht. Verwenden Sie stattdessen ` bcp47Name()` (), wenn Sie einen vollständigen Locale-Namen benötigen, oder bilden Sie die Zeichenkette, mit der Sie eine Locale identifizieren möchten, aus den zurückgegebenen Werten, indem Sie deren ` language()` an ` languageToCode()` übergeben – und verfahren Sie analog für das Skript und das Gebiet.

Siehe auch „ QLocale()“, „ language()“, „ script()“, „ territory()“, „ bcp47Name()“ und „ uiLanguages()“.

QString QLocale::nativeLanguageName() const

Gibt einen einheimischen Namen der Sprache für die Locale zurück. Zum Beispiel „Schweizer Hochdeutsch“ für die Locale „Schweizer Deutsch“.

Siehe auch nativeTerritoryName() und languageToString().

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

Gibt den einheimischen Namen des Gebiets für die Sprachumgebung zurück. Zum Beispiel „España“ für die Sprachumgebung „Spanisch/Spanien“.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch „ nativeLanguageName()“ und „ territoryToString()“.

QString QLocale::negativeSign() const

Gibt das Minuszeichen dieser Locale zurück.

Dies ist ein Token, das vermutlich als Präfix vor einer Zahl verwendet wird, um anzuzeigen, dass diese negativ ist. Es wird (seit Qt 6.0) als Zeichenkette zurückgegeben, da es in einigen Locales nicht aus einem einzigen Zeichen besteht – beispielsweise, weil es ein Zeichen zur Steuerung der Textrichtung enthält.

Siehe auch positiveSign() und toString().

QLocale::NumberOptions QLocale::numberOptions() const

Gibt die Optionen zurück, die sich auf Zahlenkonvertierungen für diese „ QLocale “-Instanz beziehen.

Standardmäßig sind für die Standard-Locales keine Optionen festgelegt, mit Ausnahme der Locale „C“, bei der standardmäßig „ OmitGroupSeparator “ gesetzt ist.

Siehe auch setNumberOptions(), toString(), groupSeparator() und FloatingPointPrecisionOption.

QString QLocale::percent() const

Gibt das Prozentzeichen dieser Locale zurück.

Dies ist ein Token, das vermutlich an eine Zahl angehängt wird, um einen Prozentsatz anzuzeigen. Es wird (seit Qt 6.0) als Zeichenkette zurückgegeben, da es in einigen Locales nicht aus einem einzigen Zeichen besteht – beispielsweise, weil es ein Zeichen zur Steuerung der Textrichtung enthält.

Siehe auch ` toString()`.

QString QLocale::pmText() const

Gibt den lokalisierten Namen des Suffixes „PM“ für Zeiten zurück, die gemäß den Konventionen der 12-Stunden-Uhr angegeben wurden.

Siehe auch amText().

QString QLocale::positiveSign() const

Gibt das Vorzeichen für positive Zahlen dieser Locale zurück.

Es handelt sich hierbei um ein Token, das vermutlich als Präfix vor einer Zahl verwendet wird, um anzuzeigen, dass diese positiv ist. Es wird (seit Qt 6.0) als Zeichenkette zurückgegeben, da es in einigen Locales nicht aus einem einzigen Zeichen besteht – beispielsweise, weil es ein Zeichen zur Steuerung der Textrichtung enthält.

Siehe auch negativeSign() und toString().

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

Gibt „ str “ zurück, das gemäß der aktuellen Locale unter Verwendung der angegebenen Anführungs style en formatiert ist.

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

Diese Funktion wurde in Qt 6.0 eingeführt.

QLocale::Script QLocale::script() const

Gibt das Skript dieser Locale zurück.

Siehe auch language(), territory(), languageToString(), scriptToString() und bcp47Name().

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

Gibt den vierstelligen Schriftcode für „ script “ zurück, wie er in der Norm ISO 15924 definiert ist.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch „ script()“, „ name()“, „ bcp47Name()“, „ languageToCode()“ und „ territoryToCode()“.

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

Gibt ein ` QString ` zurück, das den Namen von ` script` enthält.

Siehe auch languageToString(), territoryToString(), script() und bcp47Name().

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

Legt die globale Standard-Locale auf „ locale “ fest.

Diese Locale wird verwendet, wenn ein ` QLocale `-Objekt ohne Argumente erstellt wird. Wird diese Funktion nicht aufgerufen, wird die System-Locale verwendet.

Warnung: Diese Funktion ist nicht reentrant.

Siehe auch ` system()` und ` c()`.

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

Legt die „ options “ fest, die sich auf Zahlenkonvertierungen für diese „ QLocale “-Instanz beziehen.

Siehe auch ` numberOptions()` und ` FloatingPointPrecisionOption`.

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

Gibt den lokalisierten Namen des Wochentags „ day “ zurück (wobei 1 für Montag, 2 für Dienstag usw. steht), der als eigenständiger Text verwendet wird, und zwar in dem unter type angegebenen Format.

Wenn die Lokalisierungsinformationen keinen eigenständigen Tagesnamen angeben, entspricht der Rückgabewert dem von ` dayName()`.

Siehe auch dayName() und standaloneMonthName().

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

Gibt den lokalisierten Namen von ` month ` zurück, der als eigenständiger Text verwendet wird, und zwar in dem Format, das unter type angegeben ist.

Wenn die Lokalisierungsinformationen keinen eigenständigen Monatsnamen angeben, entspricht der Rückgabewert dem von ` monthName()`.

Siehe auch ` monthName()` und ` standaloneDayName()`.

[noexcept] void QLocale::swap(QLocale &other)

Tauscht diese Ländereinstellung gegen „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

[static] QLocale QLocale::system()

Gibt ein „ QLocale “-Objekt zurück, das auf die System-Locale initialisiert ist.

Die System-Locale kann, sofern verfügbar, systemspezifische Quellen für Locale-Daten verwenden; andernfalls greift sie auf den integrierten Datenbankeintrag von „ QLocale “ für die vom System gemeldete Sprache, das Schriftzeichen und das Gebiet zurück.

Unter Windows und Mac verwendet diese Locale beispielsweise die im Systemkonfigurationsfenster festgelegten Dezimal- und Gruppierungszeichen sowie Datums- und Zeitformate.

Siehe auch c().

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

Gibt das Gebiet dieser Locale zurück.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch language(), script(), territoryToString() und bcp47Name().

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

Gibt den zweistelligen Ländercode für territory zurück, wie er im ISO 3166-Standard definiert ist.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch codeToTerritory(), territory(), name(), bcp47Name(), languageToCode() und scriptToCode().

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

Gibt ein ` QString ` zurück, das den Namen von ` territory` enthält.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch ` languageToString()`, ` scriptToString()`, ` territory()` und ` bcp47Name()`.

Qt::LayoutDirection QLocale::textDirection() const

Gibt die Textrichtung der Sprache zurück.

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

Gibt das für die aktuelle Ländereinstellung verwendete Zeitformat zurück.

Wenn ` format ` auf ` LongFormat` gesetzt ist, ist das Format ausführlich, andernfalls ist es kurz. Beispielsweise lautet ` LongFormat ` für die Locale ` en_US ` ` h:mm:ss AP t`, und ` ShortFormat ` ist ` h:mm AP`.

Siehe auch QTime::toString() und QTime::fromString().

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

Gibt eine lokalisierte Zeichenfolgendarstellung von „ value “ als Währung zurück. Wenn „ symbol “ angegeben wird, wird dieses anstelle des Standard-Währungssymbols verwendet.

Siehe auch currencySymbol().

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

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

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

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

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

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

Gibt eine lokalisierte Zeichenfolgendarstellung von value als Währung zurück. Wenn symbol angegeben wird, wird dieses anstelle des Standard-Währungssymbols verwendet. Wenn precision angegeben wird, wird dies verwendet, um die Genauigkeit des Währungswerts festzulegen.

Siehe auch currencySymbol().

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

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

Liest „ string “ als Datum im lokalisierungsspezifischen Format „ format “.

Analysiert „ string “ und gibt das darin enthaltene Datum zurück. Das Format der Datumszeichenfolge richtet sich nach dem Parameter „ format “ (siehe dateFormat()).

Einige Locales verwenden, insbesondere für ShortFormat, nur die letzten beiden Ziffern des Jahres. In einem solchen Fall werden zunächst die 100 Jahre, die bei baseYear beginnen, als Kandidaten berücksichtigt. Vor Version 6.7 gab es keinen Parameter „ baseYear “ und es wurde immer das Jahr 1900 verwendet. Dies ist die Standardeinstellung für „ baseYear “, wobei ein Jahr zwischen diesem Zeitpunkt und 1999 ausgewählt wird. In einigen Fällen können andere Felder dazu führen, dass das nächste oder vorherige Jahrhundert ausgewählt wird, um ein Ergebnis zu erhalten, das mit allen angegebenen Feldern übereinstimmt. Weitere Informationen finden Sie unter QDate::fromString().

Wenn das Datum nicht analysiert werden konnte, wird ein ungültiges Datum zurückgegeben.

Siehe auch dateFormat(), toTime(), toDateTime() und QDate::fromString().

QDate QLocale::toDate(const QString &string, const QString &format, int baseYear = DefaultTwoDigitBaseYear) const

Liest „ string “ als Datum im angegebenen Format „ format “.

Analysiert „ string “ und gibt das Datum zurück, das es darstellt. Informationen zur Interpretation von „ format “ finden Sie unter „ QDate::fromString()“.

Wenn „ format “ nur die letzten beiden Ziffern eines Jahres angibt, werden zunächst die 100 Jahre, beginnend mit „ baseYear “, als mögliche Werte in Betracht gezogen. Vor Version 6.7 gab es keinen „ baseYear “-Parameter, und es wurde immer das Jahr 1900 verwendet. Dies ist die Standardeinstellung für „ baseYear “, wobei ein Jahr zwischen diesem Zeitpunkt und 1999 ausgewählt wird. In einigen Fällen können andere Felder dazu führen, dass das nächste oder vorherige Jahrhundert ausgewählt wird, um ein Ergebnis zu erhalten, das mit allen angegebenen Feldern übereinstimmt. Details finden Sie unter QDate::fromString().

Wenn das Datum nicht analysiert werden konnte, wird ein ungültiges Datum zurückgegeben.

Siehe auch dateFormat(), toTime(), toDateTime() und QDate::fromString().

QDate QLocale::toDate(const QString &string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDate QLocale::toDate(const QString &string, const QString &format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

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

Liest „ string “ als Datums- und Zeitangabe im lokalisierungsspezifischen Format „ format “.

Analysiert „ string “ und gibt das darin enthaltene Datum und die Uhrzeit zurück. Das Format der Datumszeichenfolge richtet sich nach dem Parameter „ format “ (siehe „ dateFormat()“).

Einige Sprachumgebungen verwenden, insbesondere für „ ShortFormat “, nur die letzten beiden Ziffern des Jahres. In einem solchen Fall werden zunächst die 100 Jahre ab „ baseYear “ in Betracht gezogen. Vor Version 6.7 gab es keinen Parameter „ baseYear “ und es wurde immer das Jahr 1900 verwendet. Dies ist die Standardeinstellung für „ baseYear “, wobei ein Jahr zwischen diesem Zeitpunkt und 1999 ausgewählt wird. In einigen Fällen können andere Felder dazu führen, dass das nächste oder vorherige Jahrhundert ausgewählt wird, um ein Ergebnis zu erhalten, das mit allen angegebenen Feldern übereinstimmt. Weitere Informationen finden Sie unter QDate::fromString().

Wenn die Zeichenkette nicht geparst werden konnte, wird ein ungültiges ` QDateTime` zurückgegeben.

Siehe auch dateTimeFormat(), toTime(), toDate() und QDateTime::fromString().

QDateTime QLocale::toDateTime(const QString &string, const QString &format, int baseYear = DefaultTwoDigitBaseYear) const

Liest „ string “ als Datums- und Zeitangabe im angegebenen Format „ format “.

Analysiert „ string “ und gibt das darin enthaltene Datums- und Zeitformat zurück. Informationen zur Interpretation von „ format “ finden Sie unter „ QDateTime::fromString()“.

Wenn „ format “ nur die letzten beiden Ziffern eines Jahres angibt, werden zunächst die 100 Jahre, beginnend mit „ baseYear “, als Kandidaten in Betracht gezogen. Vor Version 6.7 gab es keinen Parameter „ baseYear “, und es wurde immer das Jahr 1900 verwendet. Dies ist die Standardeinstellung für „ baseYear “, wodurch ein Jahr zwischen diesem Zeitpunkt und 1999 ausgewählt wird. In einigen Fällen können andere Felder dazu führen, dass das nächste oder vorherige Jahrhundert ausgewählt wird, um ein Ergebnis zu erhalten, das mit allen angegebenen Feldern konsistent ist. Siehe QDate::fromString() für Details.

Wenn die Zeichenkette nicht geparst werden konnte, wird ein ungültiges ` QDateTime` zurückgegeben. Wenn die Zeichenfolge analysiert werden kann und ein ungültiges Datums- und Zeitformat darstellt (z. B. in einer Lücke, die durch einen Zeitzonenwechsel übersprungen wurde), stellt das zurückgegebene ` QDateTime ` ein nahegelegenes Datums- und Zeitformat dar, das gültig ist (typischerweise unterscheidet es sich davon um die Breite der Lücke in gültigen Datums- und Zeitformaten, z. B. die durch einen Zeitzonenwechsel übersprungene Stunde). Wird dieser Wert an `fromMSecsSinceEpoch()` übergeben, ergibt sich ein gültiges Datums- und Zeitformat, das nicht originalgetreu durch die geparste Zeichenfolge dargestellt wird.

Siehe auch dateTimeFormat(), toTime(), toDate() und QDateTime::fromString().

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDateTime QLocale::toDateTime(const QString &string, const QString &format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

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

Gibt den Double-Wert zurück, der durch die lokalisierte Zeichenfolge „ s “ dargestellt wird.

Gibt „unendlich“ zurück, wenn bei der Konvertierung ein Überlauf auftritt, oder 0,0, wenn die Konvertierung aus einem anderen Grund fehlschlägt (z. B. Unterlauf).

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

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

Beachten Sie, dass die letzte Konvertierung 1234,0 zurückgibt, da „.“ in der deutschen Ländereinstellung das Tausendertrennzeichen ist.

Diese Funktion ignoriert führende und nachgestellte Leerzeichen.

Siehe auch toFloat(), toInt() und toString().

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

Gibt den Double-Wert zurück, der durch die lokalisierte Zeichenfolge „ s “ dargestellt wird.

Gibt „unendlich“ zurück, wenn es bei der Konvertierung zu einem Überlauf kommt, oder 0,0, wenn die Konvertierung aus einem anderen Grund fehlschlägt (z. B. Unterlauf).

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

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

Beachten Sie, dass die letzte Konvertierung 1234,0 zurückgibt, da „.“ in der deutschen Ländereinstellung das Tausendertrennzeichen ist.

Diese Funktion ignoriert führende und nachgestellte Leerzeichen.

Siehe auch toFloat(), toInt() und toString().

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

Gibt den Float-Wert zurück, der durch die lokalisierte Zeichenfolge „ s “ dargestellt wird.

Gibt „unendlich“ zurück, wenn bei der Konvertierung ein Überlauf auftritt, oder 0,0, wenn die Konvertierung aus einem anderen Grund fehlschlägt (z. B. Unterlauf).

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

Diese Funktion ignoriert führende und nachgestellte Leerzeichen.

Siehe auch toDouble(), toInt() und toString().

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

Gibt den Float-Wert zurück, der durch die lokalisierte Zeichenfolge „ s “ dargestellt wird.

Gibt „unendlich“ zurück, wenn bei der Konvertierung ein Überlauf auftritt, oder 0,0, wenn die Konvertierung aus einem anderen Grund fehlschlägt (z. B. Unterlauf).

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

Diese Funktion ignoriert führende und nachfolgende Leerzeichen.

Siehe auch toDouble(), toInt() und toString().

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