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 地域コードです（一部の数値コードも認識されます）。
• codeset および modifier は無視されます。

区切り文字は、アンダースコア'_' （U+005F、「低線」）またはダッシュ'-' （U+002D、「ハイフンマイナス」）のいずれかです。 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 フィールド名を返します。

これは、このロケールを一意に指定するために必要な限り、言語、文字体系、地域（および場合によってはその他の 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 noexcept] 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規格で定義されている4文字のスクリプト「scriptCode 」に対応するQLocale::Script 列挙値を返します。

コードが無効であるか、認識されない場合は、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 列挙値を返します。

コードが無効であるか、認識されない場合は、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

day のローカライズされた名称（1は月曜日、2は火曜日…を表す）を、type で指定された形式で返します。

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

monthName() およびstandaloneDayName()も参照してください 。

QString QLocale::decimalPoint() const

このロケールの小数点区切り記号を返します。

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

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

QString QLocale::exponential() const

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

これは、一部の浮動小数点数の表記において、仮数部と指数部を区切るために使用されるトークンです。一部のロケールでは、これが単一の文字ではない場合があるため（たとえば、乗算記号と「10の累乗」演算子の表記で構成される場合など）、Qt 6.0 以降では文字列として返されます。

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 以降)、一部のロケールでは区切り文字の表現に 1 つ以上の 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

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

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

dayName() およびstandaloneMonthName()も参照してください 。

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

このロケールの短縮名。

このロケールの言語と地域を、「language_territory」という形式の文字列として返します。ここで、language は小文字の 2 文字の ISO 639 言語コード、territory は大文字の 2 文字または 3 文字の 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

指定されたロケールに対応する地域の現地語名を返します。たとえば、Spanish/Spain ロケールの場合は「España」となります。

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

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

QString QLocale::negativeSign() const

このロケールの負の符号の表示形式を返します。

これは、数値の前に付けてその数値が負であることを示すために使用されるものと想定されるトークンです。一部のロケールでは、テキスト方向制御文字が含まれているなどの理由により、1文字ではない場合があるため、（Qt 6.0以降）文字列として返されます。

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

12時間表記の規則に従って指定された時刻に対する「PM」接尾辞のローカライズされた名前を返します。

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

QString QLocale::positiveSign() const

このロケールの正の符号を示す指標を返します。

これは、数値が正であることを示すために数値の接頭辞として使用されるものと想定されるトークンです。一部のロケールでは、テキスト方向制御文字が含まれているなどの理由により、単一の文字ではない場合があるため、（Qt 6.0 以降）文字列として返されます。

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

day （1は月曜日、2は火曜日…を表す）のローカライズされた名称を、type で指定された形式で、単体のテキストとして使用される形で返します。

ロケール情報に単独の曜日名が指定されていない場合、戻り値は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 では、このロケールはシステム設定パネルで指定された小数点/区切り文字および日付/時刻の形式を使用します。

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

value を通貨としてローカライズされた文字列として返します。symbol が指定された場合、デフォルトの通貨記号の代わりにそれが使用されます。precision が指定された場合、通貨値の桁数設定に使用されます。

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

string を、ロケール固有のformat 形式の日付として読み取ります。

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

一部のロケールでは、特にShortFormat の場合、年の最後の2桁のみを使用します。そのような場合、baseYear から始まる100年間が最初に検討される候補となります。 6.7以前のバージョンでは、baseYear パラメータは存在せず、常に1900が使用されていました。これはbaseYear のデフォルト設定であり、1900年から1999年までの年が選択されます。場合によっては、他のフィールドの情報に基づいて、指定されたすべてのフィールドと整合性のある結果を得るために、次の世紀または前の世紀が選択されることがあります。詳細については、QDate::fromString()を参照してください。

日付の解析に失敗した場合は、無効な日付を返します。

関連項目: dateFormat()、toTime()、toDateTime()、およびQDate::fromString()。

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

string を、指定されたformat における日付として読み取ります。

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 のデフォルト設定であり、1900 年から 1999 年までの間の年が選択されます。場合によっては、指定されたすべてのフィールドと整合性のある結果を得るために、他のフィールドによって次の世紀または前の世紀が選択されることがあります。詳細については、QDate::fromString() を参照してください。

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

関連項目: dateTimeFormat()、toTime()、toDate()、およびQDateTime::fromString()。

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

string を、指定されたformat 形式の日時として読み取ります。

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

format が年の下2桁のみを指定している場合、baseYear から始まる100年間が最初に候補として検討される。 バージョン 6.7 以前にはbaseYear パラメータが存在せず、常に 1900 が使用されていました。これはbaseYear のデフォルト設定であり、1900 年から 1999 年までの間の年が選択されます。場合によっては、指定されたすべてのフィールドと整合性のある結果を得るために、他のフィールドに基づいて次の世紀または前の世紀が選択されることがあります。詳細については、QDate::fromString() を参照してください。

文字列を解析できなかった場合、無効なQDateTime を返します。 文字列が解析可能であり、無効な日時（例：タイムゾーンの移行によってスキップされたギャップ内）を表している場合、返されるQDateTime は、有効な最も近い日時を表します（通常、有効な日時のギャップの幅、例えば移行によってスキップされた時間分だけ、それとは異なります）。これを 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 」で表される浮動小数点数を返します。

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

ok がnullptr でない場合、*ok をfalse に設定して失敗を報告し、*ok をtrue に設定して成功を報告します。