Locale QML Type

ロケール固有のプロパティとフォーマットされたデータを提供します。詳細...

Import Statement: import QtQml

プロパティ

amText : string
decimalPoint : string
exponential : string
firstDayOfWeek : enumeration
groupSeparator : string
measurementSystem : enumeration
name : string
nativeLanguageName : string
nativeTerritoryName : string
negativeSign : string
numberOptions : enumeration
percent : string
pmText : string
positiveSign : string
textDirection : enumeration
uiLanguages : Array<string>
weekDays : Array<int>
zeroDigit : string

方法

string currencySymbol(format)
string dateFormat(type)
string dateTimeFormat(type)
string dayName(day, type)
string formattedDataSize(int bytes, int precision, DataSizeFormat format) (since 6.2)
string monthName(month, type)
string standaloneDayName(day, type)
string standaloneMonthName(month, type)
string timeFormat(type)
string toString(int i) (since 6.5)
string toString(Date date, FormatType format) (since 6.5)
string toString(Date date, string format) (since 6.5)
string toString(double f, char format, int precision) (since 6.5)

詳細

ロケール・オブジェクトはQt.locale() 関数を使用してのみ作成できます。直接作成することはできません。

これは "language[_territory][.codeset][@modifier]" あるいは "C" という形式です。Qt.locale() 関数は、指定した名前のロケールを表す JS Locale オブジェクトを返します。

Locale はデフォルトロケールの概念をサポートしており、アプリケーションの起動時にシステムのロケール設定から決定されます。Qt.locale() にパラメータが渡されなかった場合は、デフォルトのロケールオブジェクトが返されます。

Localeオブジェクトは、指定されたロケールのデータを提供する多くの関数やプロパティを提供します。

Localeオブジェクトは、Date 、Number toLocaleString()、fromLocaleString()メソッドにも渡すことができ、指定したロケールを使って文字列を変換することができます。

この例では、現在の日付をドイツ語ロケール用にフォーマットしています：

import QtQuick 2.0

Text {
    text: "The date is: " + Date().toLocaleString(Qt.locale("de_DE"))
}

次の例は、指定した数値をデフォルトロケールの正しい書式で表示します：

import QtQuick 2.0

Text {
    text: "The value is: " + Number(23443.34).toLocaleString(Qt.locale())
}

Qt Quick ロケールのデータはCommon Locale Data Repository v1.8.1に基づいています。

ロケール文字列の書式

monthName(),standaloneMonthName(),dayName(),standaloneDayName() では、以下の列挙型の値を使用して日付オブジェクトの文字列表現のフォーマットを指定することができます。

定数	説明
`Locale.LongFormat`	例えば、月名として "January" を返します。
`Locale.ShortFormat`	月名として "Jan "を返すなど。
`Locale.NarrowFormat`	スペースが限られている場合に使用する、曜日名と月名の特別バージョン。ロケールが狭い名前をサポートしていない場合、狭い書式には異なる月や日に同じテキストが含まれたり、空文字列になったりする可能性があることに注意しましょう。また、システムロケールでは、この書式はShortFormatと同じです。

さらに、double-to-string変換関数とstring-to-double変換関数は、以下のライセンスでカバーされています：

本ソフトウェアを使用、複製、変更、頒布することを無償で許可します。ただし、本ソフトウェアの複製物または変更物を含むソフトウェアのすべての複製物、およびそのようなソフトウェアのサポート文書のすべての複製物に、この通知全体を含めることを条件とします。

本ソフトウェアは「現状のまま」提供され、明示または黙示の保証は一切ありません。特に、本ソフトウェアの商品性または特定目的への適合性に関して、作者およびAt&Tはいかなる表明または保証も行いません。

本製品には、カリフォルニア大学バークレー校およびその貢献者によって開発されたソフトウェアが含まれています。

Date およびNumberも参照してください。

プロパティ・ドキュメンテーション

amText : string

ローカライズされた "AM "接尾辞の名前。

decimalPoint : string

このロケールの小数点文字を保持する。

exponential : string

このロケールの指数文字を保持します。

firstDayOfWeek : enumeration

現在のロケールにおける週の最初の曜日を保持します。

定数	説明
`Locale.Sunday`	0
`Locale.Monday`	1
`Locale.Tuesday`	2
`Locale.Wednesday`	3
`Locale.Thursday`	4
`Locale.Friday`	5
`Locale.Saturday`	6

注：これらの値はJS Date APIと一致しますが、Qt C++ APIではQt::Sunday = 7です。

groupSeparator : string

このロケールのグループ区切り文字を保持します。

measurementSystem : enumeration

このプロパティは、計測に使用する単位を定義します。

定数	説明
`Locale.MetricSystem`	この値はメートル、センチメートル、ミリメートルなどのメートル単位を表します。
`Locale.ImperialUSSystem`	この値は、米国で使用されているインチやマイルなどの帝国単位を示します。
`Locale.ImperialUKSystem`	この値は、イギリスで使用されているインチやマイルなどの帝国単位を示します。
`Locale.ImperialSystem`	互換性のために提供されます。Locale.ImperialUSSystemと同じです。

name : string

このロケールの言語と地域を "language_territory "という形式の文字列で保持します。languageは小文字の2文字のISO 639言語コードで、territoryは大文字の2文字または3文字のISO 3166地域コードです。

nativeLanguageName : string

ロケール固有の言語名。たとえば、スイス・ドイツ語ロケールの場合は "Schwiizertütsch" となります。

nativeTerritoryNameも参照。

nativeTerritoryName : string

ロケール固有の地域名を保持します。たとえば、スペイン語/スペイン語のロケールでは "España" となります。

nativeLanguageNameも参照。

negativeSign : string

このロケールの負符号文字を保持します。

numberOptions : enumeration

数値から文字列、文字列から数値への変換オプションを保持します。

Number::toLocaleString() およびNumber::fromLocaleString() も参照ください。

percent : string

このロケールのパーセント文字を保持します。

pmText : string

ローカライズされた "PM" 接尾辞の名前。

positiveSign : string

このロケールの正符号を表します。

textDirection : enumeration

言語のテキスト方向を保持します：

定数	説明
`Qt.LeftToRight`	テキストは通常左側から始まります。
`Qt.RightToLeft`	テキストは通常右側から始まります。

uiLanguages : Array<string>

翻訳用のロケール名を優先度順に並べたリストを返します。

返り値は、ユーザが UI の翻訳を期待するロケール名を表します。

リストの最初の項目が最も優先されます。

weekDays : Array<int>

現在のロケールにおける曜日 (日曜日を 0、土曜日を 6 とします) の配列を保持します。

firstDayOfWeekも参照ください。

zeroDigit : string

このロケールのゼロ桁の文字を返します。

メソッドのドキュメント

string currencySymbol(format)

指定したformat の通貨記号を返します：

定数	説明
`Locale.CurrencyIsoCode`	通貨の ISO-4217 コード。
`Locale.CurrencySymbol`	通貨記号。
`Locale.CurrencyDisplayName`	ユーザが読める通貨名。

Number::toLocaleCurrencyString()も参照ください 。

string dateFormat(type)

現在のロケールで使用する日付書式を返します。type で、返すFormatType を指定します。

Dateも参照。

string dateTimeFormat(type)

type は、返すFormatType を指定します。

Dateも参照。

string dayName(day, type)

type で指定したオプションのFormatType で、ローカライズされたday の名前 (0 が日曜日、1 が月曜日など) を返します。

monthName() およびstandaloneDayName() も参照。

[since 6.2] string formattedDataSize(int bytes, int precision, DataSizeFormat format)

bytes のサイズを、数値と定量化された単位からなる、人間が読めるローカライズされた文字列に変換する。

引数precision およびformat は省略可能である。

詳細については、QLocale::formattedDataSize() を参照してください。

このメソッドは Qt 6.2 で導入されました。

QLocale::DataSizeFormatsも参照してください。

string monthName(month, type)

type で指定されたオプションのFormatType で、ローカライズされたmonth の名前（0-11）を返します。

注意: QLocale C++ APIは(1-12)の範囲を想定していますが、Locale.monthName()はJS Dateオブジェクトのように0-11を想定しています。

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

string standaloneDayName(day, type)

type で指定したFormatType で、単体テキストとして使用するday (0 が日曜日、1 が月曜日など) のローカライズ名を返します。

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

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

string standaloneMonthName(month, type)

type で指定されたオプションのFormatType で、単体テキストとして使用されるmonth の地域化された名前 (0-11) を返す。

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

注意: QLocale C++ APIは(1-12)の範囲を想定していますが、 Locale.standaloneMonthName()はJS Dateオブジェクトの0-11を想定しています。

monthName() およびstandaloneDayName()も参照 。

string timeFormat(type)

type は、返すFormatType を指定します。

Dateも参照。

[since 6.5] string toString(int i)

i のローカライズされた文字列表現を返します。

このメソッドは Qt 6.5 で導入されました。

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

[since 6.5] string toString(Date date, FormatType format = LongFormat)

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

指定されたformat における、指定されたdate のローカライズされた文字列表現を返す。format が省略された場合は、Locale.LongFormat が使用されます。

このメソッドは Qt 6.5 で導入されました。

QLocale::toString(QDate, QLocale::FormatType)も参照してください 。

[since 6.5] string toString(Date date, string format)

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

指定されたformat における、指定されたdate のローカライズされた文字列表現を返します。format が空文字列の場合、空文字列が返されます。

このメソッドは Qt 6.5 で導入されました。

QLocale::toString(QDate, QStringView)も参照してください 。

[since 6.5] string toString(double f, char format = 'g', int precision = 6)

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

浮動小数点数f を表す文字列を返す。

表現の形式は、オプションのパラメータformat とprecision によって制御される。

詳細はQLocale::toString(double, char, int)を参照してください。

このメソッドは Qt 6.5 で導入されました。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.