QLocale Class

メンバ関数ドキュメント

QLocale::QLocale()

デフォルトのロケールで初期化された QLocale オブジェクトを作成します。

setDefault() を使用してデフォルトロケールを設定していない場合は、 このロケールはsystem() が返すものと同じになります。

setDefault() およびsystem()も参照 ください。

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

指定されたname で QLocale オブジェクトを構築する。

名前は "language[_script][_territory][.codeset][@modifier]"または "C "のフォーマットを持っています：

• languageは、小文字の2文字のISO 639言語コード(3文字のコードもいくつか認識される)、
• scriptは大文字の4文字のISO 15924スクリプトコード、
• territoryは大文字の2文字で、ISO 3166の領域コード (いくつかの数値コードも認識される)。
• コードセットと修飾子は無視されます。

区切り文字はアンダースコア'_' (U+005F、"low line") またはダッシュ'-' (U+002D、"hyphen-minus") のいずれかです。QLocale に指定した言語、スクリプト、地域の組み合わせに対応するデータがない場合は、代わりに最も適切なものを使用します。文字列がロケール形式に違反していたり、 指定したキーに対応するデータが見つからなかったりした場合は、 代わりに "C" ロケールを使用します。

このコンストラクタは、QLocale(Language, Script, Territory) や QLocale(Language, Territory) よりもはるかに遅いです。

この関数は Qt 6.3 で導入されました。

bcp47Name() およびMatching combinations of language, script and territoryも参照してください 。

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

指定したlanguage およびterritory に対応する QLocale オブジェクトを構築します。

この組み合わせに対して複数のスクリプトが使用されている場合は、 可能性の高いスクリプトが選択されます。QLocale に、指定したlanguage に対するデータがない場合は、デフォルトのロケールが使用されます。QLocale に指定したlanguage とterritory の組み合わせのデータがない場合は、 代わりに代替の地域が使われるかもしれません。

setDefault() およびMatching combinations of language, script and territoryも参照 。

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

指定されたlanguage,script,territory に対応する QLocale オブジェクトを構築します。

QLocale が指定した組み合わせに対応するデータを持っていない場合は、 可能な限り対応するデータを探します。もし

• language が で、 から推測できる言語がない場合、デフォルトのロケールに戻ります。AnyLanguage script territory
• QLocale にその言語のデータがない。language として指定されているか、上記のように推測される。

setDefault() およびMatching combinations of language, script and territoryも参照して ください。

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

これはオーバーロードされた関数である。

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

other のコピーとして QLocale オブジェクトを構築します。

[noexcept] QLocale::~QLocale()

デストラクタ

QString QLocale::amText() const

AM関数は、12時間時計の慣習で指定された時刻の接尾辞 "AM "をローカライズした名前を返します。

pmText()も参照 。

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

BCP47のフィールド名をダッシュでつないで返します。

これは、このロケールを一意に指定するのに必要な数だけ、このロケールの言語、スクリプト、地域（および場合によっては他のBCP47フィールド）を組み合わせたものである。UnicodeコンソーシアムのLikely Subtag Rules 、省略されたフィールドが保持される場合には、フィールドを省略することができることに注意すること。他の形式が必要な場合、個々のフィールドから文字列を作成する方法についてはname() を参照のこと。

uiLanguages() とは異なり、 bcp47Name() が返す値はQLocale データのロケール名を表す。

この関数は、ロケール名をRFC 5646で定義されているIETF Best Common Practice 47に準拠させようとします。Qt 6.7 以降では、オプションのseparator パラメータをサポートしています。このパラメータを使用すると、BCP47 で指定されているタグの区切りにハイフンを使用することをオーバーライドできます。ただし、IETFで定義されたプロトコルで使用する場合は、デフォルトのQLocale::TagSeparator::Dash 。

name()、language()、territory()、script()、uiLanguages()も参照のこと 。

[static] QLocale QLocale::c()

C" ロケールで初期化したQLocale オブジェクトを返します。

このロケールは en_US に基づいていますが、簡略化された数値書式や独自の日付書式など、さまざまな独自の癖があります。C」プログラミング言語の標準ライブラリ関数の動作を記述するPOSIX標準を実装している。

特に、照合順序が文字のASCII値に基づいており、(大文字小文字を区別してソートする場合)すべての大文字がどの小文字よりも先にソートされるようになっています(各文字の大文字と小文字が互いに隣接してソートされるのではなく、次の文字の2つの形式の前にソートされます)。

system()も参照 。

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

ISO 639規格で定義されている2文字または3文字のlanguageCode に対応するQLocale::Language enumを返す。

指定された場合、codeTypes は、変換のために考慮するコードのセットを選択します。デフォルトでは、Qt が知っているすべてのコードが考慮されます。コードは以下の順序でマッチします：ISO639Part1 ISO639Part2B,ISO639Part2T,ISO639Part3,LegacyLanguageCode 。

コードが無効であるか、知られていない場合、QLocale::AnyLanguage が返されます。

この関数は Qt 6.3 で導入されました。

languageToCode(),codeToTerritory(),codeToScript()も参照してください 。

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

ISO 15924 標準で定義されている四文字スクリプトscriptCode に対応するQLocale::Script enum を返す。

コードが無効な場合や不明な場合はQLocale::AnyScript が返されます。

この関数は Qt 6.1 で導入されました。

scriptToCode(),codeToLanguage(),codeToTerritory()も参照してください 。

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

ISO 3166 標準で定義されている 2 文字または 3 桁のterritoryCode に対応するQLocale::Territory enum を返す。

コードが無効な場合や不明な場合はQLocale::AnyTerritory が返されます。

この関数は Qt 6.2 で導入されました。

territoryToCode(),codeToLanguage(),codeToScript()も参照してください 。

QLocale QLocale::collation() const

照合に使用するロケールを返します。

通常はこのロケールを返しますが、 システムロケール (デフォルトのロケールが一般的です) の場合はシステムの照合順序ロケールを返します。この結果はQCollator のコンストラクタに渡すのに適しています。

QCollatorも参照 。

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

ロケールで定義されている区切り文字で、指定したlist の文字列の結合を表す文字列を返します。

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

format に従った通貨記号を返します。

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

現在のロケールで使われている日付書式を返す。

format がLongFormat の場合、書式は精緻なものになり、そうでない場合は短いものになる。たとえば、en_US ロケールのLongFormat はdddd, MMMM d, yyyy 、ShortFormat はM/d/yy となります。

QDate::toString() およびQDate::fromString()も参照のこと 。

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

現在のロケールで使われている日付時刻書式を返す。

format がLongFormat の場合、書式は精巧なものになり、そうでない場合は短いものになる。たとえば、en_US ロケールのLongFormat はdddd, MMMM d, yyyy h:mm:ss AP t となり、ShortFormat はM/d/yy h:mm AP となります。

QDateTime::toString() およびQDateTime::fromString()も参照の こと。

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

type で指定されたフォーマットで、ローカライズされたday （1 が月曜日、2 が火曜日など）の名前を返す。

たとえば、ロケールがen_US でday が 1 の場合、LongFormat はMonday 、ShortFormat はMon 、NarrowFormat はM を返す。

monthName() およびstandaloneDayName()も参照のこと 。

QString QLocale::decimalPoint() const

このロケールの小数部の区切り文字を返します。

これは、小数部を持つ数値の表現において、整数部と小数部を区切るトークンです。これは一般に「小数点文字」と呼ばれ、多くのロケールでは「点」(あるいは同様のドット)ではありません。これは（Qt 6.0 以降では）文字列として返されます。これは、あるロケールが区切り文字を表すために複数の UTF-16 コードポイントを必要とする場合に備えています。

groupSeparator() およびtoString()も参照してください 。

QString QLocale::exponential() const

このロケールの指数セパレータを返します。

これは、いくつかの浮動小数点数値表現において、仮数と指数を分離するために使用されるトークンです。Qt 6.0 以降は）文字列として返されます。これは、ロケールによっては、1 文字ではないためです。例えば、乗算記号と「10の累乗」演算子の表現で構成されている場合があります。

toString(double, char, int)も参照してください 。

Qt::DayOfWeek QLocale::firstDayOfWeek() const

現在のロケールに従った週の最初の曜日を返します。

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

バイト単位のサイズを、数値と数量化された単位からなる、人間が読めるローカライズされた文字列に変換する。量化子は、数値が少なくとも1であり、できるだけ小さくなるように選択される。たとえば、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 は、それらを乱用する。

QString QLocale::groupSeparator() const

このロケールの桁区切りセパレータを返します。

これは、長い数字の並びを分割して読みやすくするためのトークンです。ロケールによっては空であることもあり、その場合は桁をグループ分けしないことを示す。他のロケールでは、スペーシング文字になることもあります。Qt 6.0 からは）文字列として返されます。これは、ロケールによっては、セパレータを表すために複数の UTF-16 コードポイントが必要な場合に備えています。

decimalPoint() およびtoString()も参照してください 。

QLocale::Language QLocale::language() const

このロケールの言語を返します。

script()、territory()、languageToString() およびbcp47Name()も参照 ください。

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

ISO 639 標準で定義されているlanguage の 2 文字または 3 文字の言語コードを返す。

指定された場合、codeTypes は、考慮するコードのセットを選択します。language で定義されているセットの最初のコードが返されます。そうでない場合は、すべてのISO-639コードが考慮される。コードは以下の順番で考慮される：ISO639Part1 ISO639Part2B,ISO639Part2T,ISO639Part3.LegacyLanguageCode は、この関数では無視される。

この関数は Qt 6.3 で導入されました。

codeToLanguage(),language(),name(),bcp47Name(),territoryToCode(),scriptToCode()も参照してください 。

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

language の名前を含むQString を返す。

territoryToString()、scriptToString()、bcp47Name()も参照のこと 。

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

指定したlanguage,script,territory にマッチする有効なロケールオブジェクトの一覧を返します。

すべてのロケールの一覧を取得する:QList<QLocale> allLocales = QLocale::matchingLocales(QLocale::AnyLanguage,QLocale::AnyScript,QLocale::AnyTerritory)；

ロシアに適したロケールのリストの取得:QList<QLocale> locales = QLocale::matchingLocales(QLocale::AnyLanguage,QLocale::AnyScript,QLocale::Russia)；

QLocale::MeasurementSystem QLocale::measurementSystem() const

ロケールの計測方式を返します。

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

type で指定された形式で、ローカライズされたmonth の名前を返す。

たとえば、ロケールがen_US でmonth が 1 の場合、LongFormat はJanuary を返し、 は を返します。 ShortFormat Jan を返し、NarrowFormat J を返します。

dayName() およびstandaloneMonthName()も参照 。

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

このロケールの短い名前。

このロケールの言語と領域を "language_territory" という形式の文字列で返します。 language は小文字の二文字の ISO 639 言語コード、territory は大文字の二文字あるいは三文字の ISO 3166 領域コードとなります。ロケールに領域が指定されていない場合は、言語名のみを返します。Qt 6.7 以降では、2 つのタグを区切るデフォルトのアンダースコア文字を上書きするために、オプションのseparator パラメータを指定することができます。

QLocale オブジェクトが明示的なスクリプトで構築されていたとしても、 互換性の観点から name() にはスクリプトが含まれません。完全なロケール名が必要な場合は代わりにbcp47Name() を使用するか、language() をlanguageToCode() に渡すなどしてロケールを識別する文字列を作成し、 スクリプトや領域も同様に指定します。

QLocale()、language()、script()、territory()、bcp47Name()、uiLanguages()も参照 。

QString QLocale::nativeLanguageName() const

ロケール固有の言語名を返します。たとえば、スイス・ドイツ語ロケールの場合は "Schweizer Hochdeutsch" となります。

nativeTerritoryName() およびlanguageToString()も参照 ください。

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

そのロケールにおけるネイティブの地域名を返します。たとえば、スペイン語/スペイン語のロケールでは "España" となります。

この関数は Qt 6.2 で導入されました。

nativeLanguageName() およびterritoryToString()も参照して ください。

QString QLocale::negativeSign() const

このロケールの負の符号インジケータを返します。

このトークンは、負であることを示すために数値のプレフィックスとして使用されると推測されます。Qt 6.0 以降は）文字列として返されます。これは、ロケールによっては、1 文字ではないからです - 例えば、テキスト方向制御文字を含むからです。

positiveSign() およびtoString()も参照してください 。

QLocale::NumberOptions QLocale::numberOptions() const

このQLocale インスタンスの数値変換に関するオプションを返します。

デフォルトでは、標準ロケールにはオプションは設定されていません。 ただし、"C" ロケールにはOmitGroupSeparator がデフォルトで設定されています。

setNumberOptions()、toString()、groupSeparator() およびFloatingPointPrecisionOptionも参照 。

QString QLocale::percent() const

このロケールのパーセントマーカーを返します。

これは、パーセンテージを示すために数値に付加されるトークンであると推測されます。これは (Qt 6.0 以降では) 文字列として返されます。これは、ロケールによっては一文字でないためです (たとえば、テキスト方向制御文字が含まれるため)。

toString()も参照してください 。

QString QLocale::pmText() const

PM関数は、12時間時計の慣習で指定された時刻の接尾辞 "PM "をローカライズした名前を返します。

amText()も参照 。

QString QLocale::positiveSign() const

このロケールの正符号インジケータを返します。

これは、数値が正であることを示すために、数値のプレフィックスとして使用されるトークンであると推測されます。Qt 6.0 以降は）文字列として返されます。これは、ロケールによっては、1 文字でないためです。

negativeSign() およびtoString()も参照してください 。

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

与えられた引用符style を使って、現在のロケールに従って引用されたstr を返す。

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

これはオーバーロードされた関数です。

この関数は Qt 6.0 で導入されました。

QLocale::Script QLocale::script() const

このロケールのスクリプトを返します。

language()、territory()、languageToString()、scriptToString() およびbcp47Name()も参照 ください。

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

ISO 15924 標準で定義されているscript の 4 文字スクリプトコードを返します。

この関数は Qt 6.1 で導入されました。

script()、name()、bcp47Name()、languageToCode()、territoryToCode()も参照してください 。

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

script の名前を含むQString を返す。

languageToString()、territoryToString()、script()、bcp47Name()も参照のこと 。

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

グローバルなデフォルトロケールをlocale に設定します。 これらの値は、引数なしでQLocale オブジェクトが構築されたときに使用されます。この関数が呼ばれない場合は、システムのロケールが使用されます。

警告：この関数はリエントラントではない：この関数はリエントラントではない。

system() およびc()も参照のこと 。

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

このQLocale インスタンスの数値変換に関するoptions を設定する。

numberOptions() およびFloatingPointPrecisionOptionも参照のこと 。

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

type で指定された書式で、単体テキストとして使用されるday のローカライズされた名前 (1 は月曜日を表し、2 は火曜日を表すなど) を返す。

ロケール情報で単独の曜日名が指定されていない場合は、dayName() と同じ値を返す。

dayName() およびstandaloneMonthName()も参照のこと 。

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

type で指定された書式で、単体のテキストとして使用されるmonth のローカライズされた名前を返す。

ロケール情報で単体月名が指定されていない場合は、monthName() と同じ値を返す。

monthName() およびstandaloneDayName()も参照のこと 。

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

このロケールをother と交換する。この操作は非常に速く、失敗することはない。

[static] QLocale QLocale::system()

システムロケールを初期化したQLocale オブジェクトを返します。

システムロケールは、ロケールデータにシステム固有のソースがある場合はそれを使用し、ない場合はQLocale の組み込みデータベースからシステムが報告する言語、スクリプト、領域を使用します。

例えば、WindowsやMacでは、このロケールはシステム設定パネルで指定された10進数/グループ文字や日付/時刻フォーマットを使用します。

c()も参照のこと 。

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

このロケールの領域を返します。

この関数は Qt 6.2 で導入されました。

language(),script(),territoryToString(),bcp47Name()も参照してください 。

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

ISO 3166 標準で定義されているterritory の 2 文字の領域コードを返します。

この関数は Qt 6.2 で導入されました。

codeToTerritory(),territory(),name(),bcp47Name(),languageToCode(),scriptToCode()も参照してください 。

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

territory の名前を含むQString を返します。

この関数は Qt 6.2 で導入されました。

languageToString(),scriptToString(),territory(),bcp47Name()も参照してください 。

Qt::LayoutDirection QLocale::textDirection() const

言語のテキスト方向を返します。

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

現在のロケールで使われている時刻フォーマットを返す。

format がLongFormat の場合は精緻な書式となり、そうでない場合は短い書式となる。たとえば、en_US ロケールのLongFormat はh:mm:ss AP t 、ShortFormat はh:mm AP となる。

QTime::toString() およびQTime::fromString()も参照の こと。

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

通貨としてvalue を地域化した文字列表現を返します。symbol を指定した場合は、デフォルトの通貨記号のかわりにそれを使用します。

currencySymbol()も参照 ください。

QString QLocale::toCurrencyString(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

この関数は toCurrencyString() をオーバーロードしたものです。

通貨としてvalue を地域化した文字列表現を返します。symbol を指定すると、デフォルトの通貨記号のかわりにそれを使用します。precision を指定すると、通貨値の精度を設定します。

currencySymbol()も参照 ください。

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

この関数は toCurrencyString() をオーバーロードする。

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

string をロケール固有のformat の日付として読み込む。

string を解析し、それが表す日付を返す。日付文字列の書式は、format パラメータ (dateFormat() を参照) に従って選択される。

ロケールによっては、特にShortFormat 、西暦の下2桁のみを使用するものもある。そのような場合、baseYear から始まる100年が最初に検討される候補となる。6.7以前にはbaseYear パラメータはなく、常に1900が使用されていた。これは、baseYear のデフォルトであり、その時点から1999年までを選択する。場合によっては、与えられたすべてのフィールドと一致する結果を得るために、他のフィールドによって次の世紀や前の世紀が選択されることもある。詳細はQDate::fromString()を参照。

日付をパースできなかった場合は、無効な日付を返します。

dateFormat()、toTime()、toDateTime() およびQDate::fromString()も参照 。

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

与えられたformat の日付としてstring を読み込む。

string を解析し、それが表す日付を返す。format の解釈についてはQDate::fromString() を参照のこと。

format が西暦の下2桁のみを指定する場合、baseYear から始まる100年が最初に検討される候補となる。6.7より前にはbaseYear パラメータはなく、常に1900が使用されていた。これはbaseYear のデフォルトであり、当時から1999年までの年号が選択される。場合によっては、与えられたすべてのフィールドと一致する結果を得るために、他のフィールドによって次の世紀や前の世紀が選択されることもある。詳細はQDate::fromString()を参照。

日付をパースできなかった場合は、無効な日付を返します。

dateFormat()、toTime()、toDateTime() および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

string 、ロケール固有のformat 。

string を解析し、それが表す日時を返す。日付文字列の書式は、format パラメータ (dateFormat() を参照) に従って選択される。

ロケールによっては、特にShortFormat 、西暦の下2桁のみを使用するものもある。そのような場合、baseYear から始まる100年が最初に検討される候補となる。6.7以前にはbaseYear パラメータはなく、常に1900が使用されていた。これは、baseYear のデフォルトであり、その時点から1999年までを選択する。場合によっては、与えられたすべてのフィールドと一致する結果を得るために、他のフィールドによって次の世紀や前の世紀が選択されることもある。詳細はQDate::fromString()を参照。

文字列を解析できなかった場合は、無効なQDateTime を返す。

dateTimeFormat()、toTime()、toDate()、QDateTime::fromString()も参照のこと 。

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

指定されたformat の日付時刻としてstring を読み込む。

string を解析し、それが表す日時を返す。format の解釈についてはQDateTime::fromString() を参照のこと。

format が西暦の下2桁のみを指定する場合、baseYear から始まる100年が最初に考慮される候補となる。6.7より前にはbaseYear パラメータはなく、常に1900が使用されていた。これはbaseYear のデフォルトであり、当時から1999年までの年号が選択される。場合によっては、与えられたすべてのフィールドと一致する結果を得るために、他のフィールドによって次の世紀や前の世紀が選択されることもある。詳細はQDate::fromString()を参照。

文字列が解析できなかった場合、無効なQDateTime を返す。 文字列が解析可能で、無効な日付時刻を表す場合 (例えば、タイムゾーンの遷移によってスキップされた隙間)、無効なQDateTime が返され、その toMSecsSinceEpoch() は有効な近傍の日付時刻を表す。これを fromMSecsSinceEpoch() に渡すと、解析された文字列が忠実に表現していない有効な日付時刻が返される。

dateTimeFormat(),toTime(),toDate(),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

ローカライズされた文字列s で表される double を返します。

変換がオーバーフローした場合は無限大を返し、その他の理由（アンダーフローなど）で変換に失敗した場合は 0.0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

bool ok;
double d;

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

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

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

最後の変換で1234.0が返されることに注意。これは、ドイツ語のロケールでは'.'が千単位グループの区切り文字だからである。

この関数は、先頭と末尾の空白を無視する。

toFloat()、toInt()、toString()も参照のこと 。

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

ローカライズされた文字列s で表される double を返します。

変換がオーバーフローした場合は無限大を返し、その他の理由（アンダーフローなど）で変換に失敗した場合は 0.0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

bool ok;
double d;

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

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

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

最後の変換で1234.0が返されることに注意。これは、ドイツ語のロケールでは'.'が千単位グループの区切り文字だからである。

この関数は、先頭と末尾の空白を無視する。

toFloat()、toInt()、toString()も参照のこと 。

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

地域化された文字列s で表される float を返します。

変換がオーバーフローした場合は無限大を返し、その他の理由（アンダーフローなど）で変換に失敗した場合は 0.0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾の空白を無視する。

toDouble()、toInt()、toString()も参照のこと 。

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

地域化された文字列s で表される float を返します。

変換がオーバーフローした場合は無限大を返し、その他の理由（アンダーフローなど）で変換に失敗した場合は 0.0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾の空白を無視する。

toDouble()、toInt()、toString()も参照のこと 。

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

地域化された文字列s で表される int を返す。

変換に失敗した場合、この関数は0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾の空白を無視する。

toUInt() およびtoString()も参照のこと 。

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

地域化された文字列s で表される int を返す。

変換に失敗した場合、この関数は0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾の空白を無視する。

toUInt() およびtoString()も参照のこと 。

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

地域化された文字列s で表される long int を返す。

変換に失敗した場合、この関数は0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾の空白を無視する。

toInt()、toULong()、toDouble()、toString()も参照のこと 。

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

地域化された文字列s で表される long int を返す。

変換に失敗した場合、この関数は0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾の空白を無視する。

toInt()、toULong()、toDouble()、toString()も参照のこと 。

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

地域化された文字列s で表される long long int を返す。

変換に失敗した場合、この関数は0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾の空白を無視する。

toInt()、toULongLong()、toDouble()、toString()も参照のこと 。

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

地域化された文字列s で表される long long int を返す。

変換に失敗した場合、この関数は0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾の空白を無視する。

toInt()、toULongLong()、toDouble()、toString()も参照のこと 。

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

str の小文字のコピーを返す。

Qt Core が ICU ライブラリを使用している場合、現在のロケールの規則に従って変換が行われる。そうでない場合は、QString::toLower() を汎用的なフォールバックとして、 プラットフォーム依存の方法で変換を行うことができる。

QString::toLower()も参照のこと 。

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

地域化された文字列s で表される short int を返す。

変換に失敗した場合、この関数は0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾の空白を無視する。

toUShort() およびtoString()も参照のこと 。

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

地域化された文字列s で表される short int を返す。