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

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

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

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

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

これは、このロケールを一意に指定するのに必要な数だけ、そのロケールのlanguage、script、territory(場合によっては他の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 列挙型を返します。

指定された場合、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 インスタンスの数値変換に関するオプションを返します。

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

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

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

[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 は Monday、2 は Tuesday など) を返します。

ロケール情報で独立した曜日名が指定されていない場合、返り値は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 で表される浮動小数点数を返します。

変換がオーバーフローした場合は無限大を、その他の理由（アンダーフローなど）で変換に失敗した場合は 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 ライブラリを使用している場合、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 を返す。

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

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

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

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