Locale QML Type

ロケール固有のプロパティや書式設定済みのデータを提供します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧
• 非推奨のメンバー

プロパティ

• 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 createSeparatedList(list<string> list) (since 6.10)
• 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)

詳細な説明

Locale オブジェクトは、Qt.locale() 関数を通じてのみ作成できます。直接作成することはできません。

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

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() では、Date オブジェクトの文字列表現の書式を指定するために、以下の列挙値を使用できます。

さらに、double から文字列への変換関数および文字列から double への変換関数については、以下のライセンスが適用されます:

「Date」JavaScript オブジェクトおよび「Number」JavaScript オブジェクトも参照してください 。

プロパティのドキュメント

amText : string

12時間制の表記規則に従って指定された時刻における「AM」接尾辞のローカライズされた名称。

decimalPoint : string

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

exponential : string

このロケールの指数表記の特性を保持します。

firstDayOfWeek : enumeration

現在のロケールに基づいて、週の初日を保持します。

groupSeparator : string

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

measurementSystem : enumeration

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

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

数値から文字列への変換および文字列から数値への変換に関する一連のオプションを保持します。

string Number::toLocaleString(locale, format, precision)およびstring Number::fromLocaleString(locale, number)も参照してください 。

percent : string

このロケールのパーセント記号を格納します。

pmText : string

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

positiveSign : string

このロケールの「＋」記号を保持します。

textDirection : enumeration

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

uiLanguages : Array<string>

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

戻り値は、ユーザーが UI の翻訳が表示されることを期待しているロケール名を表します。

リストの最初の項目が、最も優先度の高いロケールです。

weekDays : Array<int>

現在のロケールに基づいて平日とみなされる日の配列を格納します。この際、日曜日は 0、土曜日は 6 として扱われます。

firstDayOfWeekも参照してください 。

zeroDigit : string

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

メソッドのドキュメント

[since 6.10] string createSeparatedList(list<string> list)

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

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

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

string currencySymbol(format)

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

関連項目: 文字列 Number::toLocaleCurrencyString(locale, symbol)。

string dateFormat(type)

現在のロケールで使用されている日付形式を返します。type は、返すFormatType を指定します。

「JavaScriptのDateオブジェクト」も参照してください 。

string dateTimeFormat(type)

現在のロケールで使用されている日時形式を返します。type は、返すFormatType を指定します。

「JavaScript の 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）を返します。

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

string standaloneDayName(day, type)

type で指定されたFormatType において、単体テキストとして使用されるday （0は日曜日、1は月曜日を表し、以下同様）のローカライズされた名前を返します。

ロケール情報に独立した曜日名が指定されていない場合、戻り値はdayName() と同じになります。

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

string standaloneMonthName(month, type)

type で指定されたオプションのFormatType において、単体のテキストとして使用される `month ` (0-11) のローカライズされた名前を返します。

ロケール情報に単独の月名が指定されていない場合、戻り値はmonthName() と同じになります。

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

string timeFormat(type)

現在のロケールで使用されている時刻形式を返します。type は、返すFormatType を指定します。

「JavaScript の 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 で導入されました。