QLocale Class

Dokumentation der Mitgliedsfunktionen

QLocale::QLocale()

Konstruiert ein QLocale-Objekt, das mit dem Standardgebietsschema initialisiert wird.

Wenn kein Standardgebietsschema mit setDefault() gesetzt wurde, ist dieses Gebietsschema dasselbe wie das, das von system() zurückgegeben wird.

Siehe auch setDefault() und system().

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

Konstruiert ein QLocale-Objekt mit dem angegebenen name.

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

• language ein klein geschriebener, zweibuchstabiger ISO 639-Sprachcode ist (einige dreibuchstabige Codes werden ebenfalls erkannt),
• script ist ein großgeschriebener, vierbuchstabiger ISO 15924-Schriftcode,
• territory ist ein großgeschriebener, zweistelliger ISO-3166-Territorialcode (einige numerische Codes werden ebenfalls erkannt), und
• Codeset und Modifier werden ignoriert.

Das Trennzeichen kann entweder ein Unterstrich '_' (U+005F, "low line") oder ein Bindestrich '-' (U+002D, "hyphen-minus") sein. Wenn QLocale keine Daten für die angegebene Kombination aus Sprache, Skript und Gebiet hat, wird stattdessen die am besten geeignete Übereinstimmung verwendet, die gefunden werden 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 das "C"-Locale verwendet.

Dieser Konstruktor ist viel 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)

Konstruiert ein QLocale-Objekt für die angegebenen language und territory.

Wenn mehr als ein Skript für diese Kombination verwendet wird, wird ein wahrscheinliches Skript ausgewählt. Wenn QLocale keine Daten für die angegebene language hat, wird das Standardgebietsschema verwendet. Wenn QLocale keine Daten für die angegebene Kombination von language und territory hat, 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)

Konstruiert ein QLocale-Objekt für die angegebenen language, script und territory.

Wenn QLocale keine Daten für die angegebene Kombination hat, wird es Daten für eine möglichst gute Übereinstimmung finden. Es greift auf das Standard Gebietsschema zurück, wenn

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

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

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

Dies ist eine überladene Funktion.

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

Konstruiert ein QLocale-Objekt als Kopie von other.

[noexcept] QLocale::~QLocale()

Zerstörer

QString QLocale::amText() const

Gibt den lokalisierten Namen des Suffixes "AM" für Zeiten zurück, die nach den Konventionen der 12-Stunden-Uhr angegeben wurden.

Siehe auch pmText().

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

Gibt die mit Bindestrichen verbundenen BCP47-Feldnamen zurück.

Dies kombiniert so viele Sprach-, Schrift- und Gebietsfelder (und möglicherweise andere BCP47-Felder) für dieses Gebietsschema, wie für seine eindeutige Angabe erforderlich sind. Beachten Sie, dass Felder weggelassen werden können, wenn die Likely Subtag Rules des Unicode-Konsortiums die weggelassenen Felder impliziert, wenn sie beibehalten werden. Siehe name() für die Konstruktion eines Strings aus einzelnen Feldern, wenn ein anderes Format benötigt wird.

Im Gegensatz zu uiLanguages() stellt der von bcp47Name() zurückgegebene Wert den Gebietsschema-Namen der QLocale -Daten dar; dies muss nicht die Sprache sein, in der die Benutzerschnittstelle sein soll.

Diese Funktion versucht, den Gebietsschema-Namen an die IETF Best Common Practice 47, definiert durch RFC 5646, anzupassen. Seit Qt 6.7 unterstützt sie einen optionalen separator -Parameter, der verwendet werden kann, um die in BCP47 spezifizierte Verwendung eines Bindestrichs zur Trennung der Tags zu überschreiben. Für die Verwendung in IETF-definierten Protokollen sollte jedoch der Standard QLocale::TagSeparator::Dash beibehalten werden.

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

[static] QLocale QLocale::c()

Gibt ein QLocale Objekt zurück, das mit dem Gebietsschema "C" initialisiert wurde.

Dieses Gebietsschema basiert auf en_US, hat aber verschiedene eigene Eigenheiten, wie z. B. 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, so dass (bei der Sortierung nach Groß- und Kleinschreibung) alle Großbuchstaben vor den Kleinbuchstaben sortiert werden (anstatt dass die Groß- und Kleinschreibung jedes Buchstabens nebeneinander und vor den beiden Formen des nächsten Buchstabens sortiert werden).

Siehe auch system().

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

Gibt die Aufzählung QLocale::Language zurück, die den zwei- oder dreibuchstabigen languageCode entspricht, wie in den ISO 639-Normen definiert.

Falls angegeben, wählt codeTypes aus, welcher Satz von Codes für die Konvertierung berücksichtigt werden soll. Standardmäßig werden alle in Qt bekannten Codes berücksichtigt. Die Codes werden in der folgenden Reihenfolge abgeglichen: ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3, LegacyLanguageCode.

Wenn der Code ungültig oder nicht bekannt ist, 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 Aufzählung QLocale::Script zurück, die dem aus vier Buchstaben bestehenden Skript scriptCode entspricht, wie in der Norm ISO 15924 definiert.

Wenn der Code ungültig oder nicht bekannt ist, 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 Aufzählung QLocale::Territory zurück, die dem zweistelligen oder dreistelligen territoryCode entspricht, wie er in der ISO-Norm 3166 definiert ist.

Wenn der Code ungültig oder nicht bekannt ist, 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 das für die Sortierung zu verwendende Gebietsschema zurück.

Das Ergebnis ist in der Regel dieses Gebietsschema; das Systemgebietsschema (das in der Regel das Standardgebietsschema ist) gibt jedoch das Gebietsschema für die Sortierung des Systems 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 gegebenen list von Zeichenketten mit einem durch das Gebietsschema definierten Trennzeichen darstellt.

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

Gibt ein Währungssymbol entsprechend der format zurück.

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

Gibt das für das aktuelle Gebietsschema verwendete Datumsformat zurück.

Wenn format gleich LongFormat ist, wird das Format ausführlich sein, andernfalls wird es kurz sein. Zum Beispiel ist LongFormat für das Gebietsschema en_US gleich dddd, MMMM d, yyyy, ShortFormat gleich M/d/yy.

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

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

Gibt das für das aktuelle Gebietsschema verwendete Datums-Zeit-Format zurück.

Wenn format gleich LongFormat ist, wird das Format ausführlich sein, andernfalls wird es kurz sein. Zum Beispiel ist LongFormat für das Gebietsschema en_US gleich dddd, MMMM d, yyyy h:mm:ss AP t, ShortFormat gleich 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 durch type festgelegten Format.

Wenn beispielsweise das Gebietsschema en_US und day gleich 1 ist, gibt LongFormat Monday , ShortFormat Mon und NarrowFormat M zurück.

Siehe auch monthName() und standaloneDayName().

QString QLocale::decimalPoint() const

Gibt das Trennzeichen für Nachkommastellen für dieses Gebietsschema zurück.

Dies ist das Zeichen, das in der Darstellung einer Zahl, die einen Bruchteil hat, den Ganzzahlteil vom Bruchteil trennt. Dies wird allgemein als "Dezimalpunktzeichen" bezeichnet - auch wenn es in vielen Sprachumgebungen kein "Punkt" (oder ein ähnlicher Punkt) ist. Es wird (seit Qt 6.0) als String zurückgegeben, falls ein Gebietsschema mehr als einen UTF-16 Code-Punkt benötigt, um sein Trennzeichen darzustellen.

Siehe auch groupSeparator() und toString().

QString QLocale::exponential() const

Gibt das Exponententrennzeichen für dieses Gebietsschema zurück.

Dies ist ein Zeichen, das verwendet wird, um Mantisse und Exponent in einigen numerischen Darstellungen von Fließkommazahlen zu trennen. Es wird (seit Qt 6.0) als String zurückgegeben, da es in einigen Gebietsschemata nicht aus einem einzelnen Zeichen besteht - zum Beispiel 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 Tag der Woche gemäß dem aktuellen Gebietsschema zurück.

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

Konvertiert eine Größe in Bytes in eine menschenlesbare lokalisierte Zeichenfolge, die eine Zahl und eine quantifizierte Einheit enthält. Der Quantifizierer wird so gewählt, dass die Zahl mindestens eins beträgt und so klein wie möglich ist. Wenn zum Beispiel bytes 16384, precision 2 und format DataSizeIecFormat (die Vorgabe) ist, gibt diese Funktion "16.00 KiB" zurück; für 1330409069609 Bytes gibt sie "1.21 GiB" zurück usw. Wenn format DataSizeIecFormat oder DataSizeTraditionalFormat ist, wird die angegebene Anzahl von Bytes durch eine Potenz von 1024 geteilt, wobei das Ergebnis kleiner als 1024 ist; für DataSizeSIFormat wird sie durch eine Potenz von 1000 geteilt, wobei das Ergebnis kleiner als 1000 ist. DataSizeIecFormat verwendet die neuen IEC-Standard-Quantifizierer Ki, Mi usw., während DataSizeSIFormat die älteren SI-Quantifizierer k, M usw. verwendet und DataSizeTraditionalFormat sie missbraucht.

QString QLocale::groupSeparator() const

Gibt das Zifferngruppentrennzeichen für dieses Gebietsschema zurück.

Dies ist ein Token, das verwendet wird, um lange Ziffernfolgen bei der Darstellung einer Zahl aufzuteilen, um sie leichter lesbar zu machen. In einigen Gebietsschemata kann es leer sein, was bedeutet, dass die Ziffern nicht auf diese Weise in Gruppen unterteilt werden sollten. In anderen Ländern kann es ein Leerzeichen sein. Es wird (seit Qt 6.0) als Zeichenkette zurückgegeben, falls ein Gebietsschema mehr als einen UTF-16-Codepunkt benötigt, um sein Trennzeichen darzustellen.

Siehe auch decimalPoint() und toString().

QLocale::Language QLocale::language() const

Gibt die Sprache dieses Gebietsschemas 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 dreibuchstabigen 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. Zurückgegeben wird der erste Code aus dem Satz, 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 der gültigen Gebietsschema-Objekte zurück, die mit den angegebenen language, script und territory übereinstimmen.

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

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

QLocale::MeasurementSystem QLocale::measurementSystem() const

Gibt das Maßsystem für das Gebietsschema zurück.

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

Gibt den lokalisierten Namen von month in dem durch type angegebenen Format zurück.

Wenn zum Beispiel das Gebietsschema en_US und month 1 ist, gibt LongFormat January zurück. ShortFormat Jan, und NarrowFormat J .

Siehe auch dayName() und standaloneMonthName().

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

Der Kurzname dieses Gebietsschemas.

Gibt die Sprache und das Gebiet dieses Gebietsschemas als Zeichenkette der Form "language_territory" zurück, wobei language ein kleingeschriebener, zweistelliger ISO 639-Sprachcode und territory ein großgeschriebener, zwei- oder dreibuchstabiger ISO 3166-Gebietscode ist. Wenn das Gebietsschema kein bestimmtes Territorium enthält, wird nur der Name der Sprache zurückgegeben. Seit Qt 6.7 kann ein optionaler separator Parameter übergeben werden, um den standardmäßigen Unterstrich, der die beiden Tags trennt, außer Kraft zu setzen.

Selbst wenn das QLocale Objekt mit einem expliziten Skript konstruiert wurde, wird name() es aus Kompatibilitätsgründen nicht enthalten. Verwenden Sie stattdessen bcp47Name(), wenn Sie einen vollständigen Gebietsschema-Namen benötigen, oder konstruieren Sie die Zeichenkette, mit der Sie ein Gebietsschema identifizieren wollen, aus den zurückgegebenen, indem Sie language() an languageToCode() übergeben und ähnliches für das Skript und das Gebiet.

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

QString QLocale::nativeLanguageName() const

Gibt den Namen der Sprache für das Gebietsschema zurück. Zum Beispiel "Schweizer Hochdeutsch" für das Gebietsschema Schweiz-Deutsch.

Siehe auch nativeTerritoryName() und languageToString().

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

Gibt einen einheimischen Namen des Gebiets für das Gebietsschema zurück. Zum Beispiel "España" für das Gebietsschema Spanisch/Spanien.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch nativeLanguageName() und territoryToString().

QString QLocale::negativeSign() const

Gibt den Indikator für das negative Vorzeichen dieses Gebietsschemas zurück.

Dies ist ein Token, das vermutlich als Präfix vor einer Zahl verwendet wird, um anzuzeigen, dass sie negativ ist. Es wird (seit Qt 6.0) als Zeichenkette zurückgegeben, da es in einigen Sprachumgebungen kein einzelnes Zeichen ist - zum Beispiel, weil es ein Text-Richtungssteuerungszeichen enthält.

Siehe auch positiveSign() und toString().

QLocale::NumberOptions QLocale::numberOptions() const

Gibt die Optionen für die Zahlenumwandlung für diese QLocale -Instanz zurück.

Standardmäßig sind keine Optionen für die Standard-Sprachumgebungen gesetzt, außer für die "C"-Sprachumgebung, für die OmitGroupSeparator standardmäßig gesetzt ist.

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

QString QLocale::percent() const

Gibt die Prozentmarke dieses Gebietsschemas zurück.

Dies ist ein Token, von dem angenommen wird, dass es an eine Zahl angehängt wird, um einen Prozentsatz anzugeben. Es wird (seit Qt 6.0) als String zurückgegeben, da es in einigen Sprachumgebungen kein einzelnes Zeichen ist - zum Beispiel, weil es ein Text-Richtungs-Steuerungszeichen enthält.

Siehe auch toString().

QString QLocale::pmText() const

Gibt den lokalisierten Namen des Suffixes "PM" für Zeiten zurück, die nach den Konventionen der 12-Stunden-Uhr angegeben wurden.

Siehe auch amText().

QString QLocale::positiveSign() const

Gibt den Indikator für das positive Vorzeichen dieses Gebietsschemas zurück.

Dies ist ein Token, das vermutlich als Präfix vor einer Zahl verwendet wird, um anzuzeigen, dass sie positiv ist. Es wird (seit Qt 6.0) als Zeichenkette zurückgegeben, da es in einigen Sprachumgebungen kein einzelnes Zeichen ist - zum Beispiel, weil es ein Text-Richtungssteuerungszeichen enthält.

Siehe auch negativeSign() und toString().

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

Gibt str in Anführungszeichen des aktuellen Gebietsschemas unter Verwendung des angegebenen Anführungszeichens style zurück.

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

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.0 eingeführt.

QLocale::Script QLocale::script() const

Gibt das Skript dieses Gebietsschemas zurück.

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

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

Gibt den aus vier Buchstaben bestehenden Skriptcode für script zurück, wie in der Norm ISO 15924 definiert.

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)

Setzt das globale Standardgebietsschema auf locale. Diese Werte werden verwendet, wenn ein QLocale Objekt ohne Argumente erstellt wird. Wenn diese Funktion nicht aufgerufen wird, wird das Gebietsschema des Systems verwendet.

Warnung: Diese Funktion ist nicht reentrant.

Siehe auch system() und c().

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

Setzt die options in Bezug auf die Zahlenumwandlung für diese QLocale Instanz.

Siehe auch numberOptions() und FloatingPointPrecisionOption.

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

Liefert den lokalisierten Namen des day (wobei 1 für Montag, 2 für Dienstag usw. steht), der als eigenständiger Text verwendet wird, in dem von type angegebenen Format.

Wenn die Gebietsschema-Informationen den Namen des eigenständigen Tages nicht angeben, ist der Rückgabewert derselbe wie in 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, in dem von type angegebenen Format.

Wenn die Gebietsschema-Informationen den eigenständigen Monatsnamen nicht angeben, ist der Rückgabewert derselbe wie in monthName().

Siehe auch monthName() und standaloneDayName().

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

Tauscht dieses Gebietsschema mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

[static] QLocale QLocale::system()

Gibt ein QLocale Objekt zurück, das mit dem Systemgebietsschema initialisiert wurde.

Das Systemgebietsschema kann systemspezifische Quellen für Gebietsschemadaten verwenden, wenn diese verfügbar sind, andernfalls greift es auf den integrierten Datenbankeintrag von QLocale für die Sprache, das Skript und das Gebiet zurück, die das System meldet.

Unter Windows und Mac verwendet dieses Gebietsschema zum Beispiel die Dezimal-/Gruppierungszeichen und Datums-/Zeitformate, die in der Systemkonfiguration angegeben sind.

Siehe auch c().

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

Gibt das Gebiet dieses Gebietsschemas 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 aus zwei Buchstaben bestehenden Gebietscode für territory zurück, wie er in der ISO-Norm 3166 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 eine QString zurück, die 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 das aktuelle Gebietsschema verwendete Zeitformat zurück.

Wenn format gleich LongFormat ist, wird das Format ausführlich sein, andernfalls wird es kurz sein. Zum Beispiel ist LongFormat für das Gebietsschema en_US gleich h:mm:ss AP t, ShortFormat gleich h:mm AP.

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

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

Gibt eine lokalisierte String-Darstellung von value als Währung zurück. Wenn symbol angegeben wird, wird es anstelle des Standardwährungssymbols verwendet.

Siehe auch currencySymbol().

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Diese Funktion überlädt toCurrencyString().

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

Siehe auch currencySymbol().

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

Diese Funktion überlastet toCurrencyString().

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

Liest string als Datum in einer ortsspezifischen format.

Analysiert string und gibt das Datum zurück, das es darstellt. Das Format der Datumszeichenfolge wird entsprechend dem Parameter format gewählt (siehe dateFormat()).

Einige Sprachumgebungen verwenden, insbesondere für ShortFormat, nur die letzten beiden Ziffern des Jahres. In diesem Fall werden die 100 Jahre, die mit baseYear beginnen, als erstes in Betracht gezogen. Vor 6.7 gab es keinen Parameter baseYear und es wurde immer 1900 verwendet. Dies ist die Standardeinstellung für baseYear, wobei ein Jahr von damals bis 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 das Datum nicht geparst 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 ein Datum in der angegebenen format.

Analysiert string und gibt das Datum zurück, das es repräsentiert. Siehe QDate::fromString() für die Interpretation von format.

Wenn format nur die letzten beiden Ziffern einer Jahreszahl angibt, werden die 100 Jahre ab baseYear als erste Kandidaten in Betracht gezogen. Vor der Version 6.7 gab es keinen Parameter baseYear und es wurde immer 1900 verwendet. Dies ist die Standardeinstellung für baseYear, wobei ein Jahr von damals bis 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 das Datum nicht geparst 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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Liest string als Datumszeit in einer ortsspezifischen format.

Analysiert string und gibt die Datumszeit zurück, die es darstellt. Das Format der Datumszeichenfolge wird entsprechend dem Parameter format gewählt (siehe dateFormat()).

Einige Gebietsschemata verwenden, insbesondere für ShortFormat, nur die letzten beiden Ziffern des Jahres. In diesem Fall werden die 100 Jahre, die mit baseYear beginnen, als erstes in Betracht gezogen. Vor 6.7 gab es keinen Parameter baseYear und es wurde immer 1900 verwendet. Dies ist die Standardeinstellung für baseYear, wobei ein Jahr von damals bis 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ültiger 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 Datumszeit in der angegebenen format.

Analysiert string und gibt die Datumszeit zurück, die es darstellt. Siehe QDateTime::fromString() für die Interpretation von format.

Wenn format nur die letzten beiden Ziffern einer Jahreszahl angibt, werden die 100 Jahre ab baseYear als erste Kandidaten in Betracht gezogen. Vor der Version 6.7 gab es keinen Parameter baseYear und es wurde immer 1900 verwendet. Dies ist die Standardeinstellung für baseYear, wobei ein Jahr von damals bis 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ültiger QDateTime zurückgegeben. Wenn die Zeichenkette geparst werden kann und eine ungültige Datumszeit darstellt (z. B. in einer Lücke, die durch einen Zeitzonenwechsel übersprungen wurde), wird ein ungültiger QDateTime zurückgegeben, dessen toMSecsSinceEpoch() eine nahegelegene, gültige Datumszeit darstellt. Die Übergabe an fromMSecsSinceEpoch() erzeugt eine gültige Datumszeit, die von der geparsten Zeichenkette nicht getreu 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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Gibt den Double zurück, der durch die lokalisierte Zeichenkette s dargestellt wird.

Gibt eine Unendlichkeit zurück, wenn die Konvertierung überläuft, oder 0,0, wenn die Konvertierung aus einem anderen Grund fehlschlägt (z. B. Unterlauf).

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

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 '.' das Tausendertrennzeichen im deutschen Gebietsschema ist.

Diese Funktion ignoriert führende und nachfolgende Leerzeichen.

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

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

Gibt den Double zurück, der durch die lokalisierte Zeichenkette s dargestellt wird.

Gibt eine Unendlichkeit zurück, wenn die Konvertierung überläuft, oder 0,0, wenn die Konvertierung aus einem anderen Grund fehlschlägt (z. B. Unterlauf).

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

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 '.' das Tausendertrennzeichen im deutschen Gebietsschema ist.

Diese Funktion ignoriert führende und nachfolgende Leerzeichen.

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

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

Gibt die durch die lokalisierte Zeichenkette s dargestellte Fließkommazahl zurück.

Gibt eine Unendlichkeit zurück, wenn die Konvertierung überläuft, oder 0,0, wenn die Konvertierung aus einem anderen Grund fehlschlägt (z. B. Unterlauf).

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

Diese Funktion ignoriert führende und abschließende Whitespace-Zeichen.

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

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

Gibt die durch die lokalisierte Zeichenkette s dargestellte Fließkommazahl zurück.

Gibt eine Unendlichkeit zurück, wenn die Konvertierung überläuft, oder 0,0, wenn die Konvertierung aus einem anderen Grund fehlschlägt (z. B. Unterlauf).

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

Diese Funktion ignoriert führende und abschließende Whitespace-Zeichen.

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

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

Gibt den int zurück, der durch die lokalisierte Zeichenkette s dargestellt wird.

Wenn die Konvertierung fehlschlägt, gibt die Funktion 0 zurück.

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

Diese Funktion ignoriert führende und abschließende Whitespaces.

Siehe auch toUInt() und toString().

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

Gibt den int zurück, der durch die lokalisierte Zeichenkette s dargestellt wird.

Wenn die Konvertierung fehlschlägt, gibt die Funktion 0 zurück.

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

Diese Funktion ignoriert führende und abschließende Whitespaces.

Siehe auch toUInt() und toString().

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

Gibt den Long-Int zurück, der durch die lokalisierte Zeichenkette s dargestellt wird.

Wenn die Konvertierung fehlschlägt, gibt die Funktion 0 zurück.

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

Diese Funktion ignoriert führende und abschließende Whitespaces.

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

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

Gibt den Long-Int zurück, der durch die lokalisierte Zeichenkette s dargestellt wird.

Wenn die Konvertierung fehlschlägt, gibt die Funktion 0 zurück.

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

Diese Funktion ignoriert führende und abschließende Leerzeichen.

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

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

Gibt den Long Long Int zurück, der durch die lokalisierte Zeichenkette s dargestellt wird.

Wenn die Konvertierung fehlschlägt, gibt die Funktion 0 zurück.

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

Diese Funktion ignoriert führende und abschließende Whitespaces.

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

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

Gibt den Long Long Int zurück, der durch die lokalisierte Zeichenkette s dargestellt wird.

Wenn die Konvertierung fehlschlägt, gibt die Funktion 0 zurück.

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

Diese Funktion ignoriert führende und abschließende Whitespaces.

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

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

Gibt eine klein geschriebene Kopie von str zurück.

Wenn Qt Core die ICU-Bibliotheken verwendet, werden diese verwendet, um die Umwandlung gemäß den Regeln des aktuellen Gebietsschemas durchzuführen. Andernfalls kann die Umwandlung auf plattformabhängige Weise erfolgen, wobei QString::toLower() als allgemeiner Fallback dient.

Siehe auch QString::toLower().

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

Gibt den kurzen int zurück, der durch die lokalisierte Zeichenkette s dargestellt wird.

Wenn die Konvertierung fehlschlägt, gibt die Funktion 0 zurück.

Wenn ok nicht nullptr ist, wird ein Fehler durch Setzen von *ok auf false und ein Erfolg durch Setzen von *ok auf true gemeldet.

Diese Funktion ignoriert führende und abschließende Whitespaces.

Siehe auch toUShort() und toString().

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

Gibt den kurzen int zurück, der durch die lokalisierte Zeichenkette s dargestellt wird.