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)

詳細

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

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

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

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

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

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

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() では、以下の列挙型の値を使用して 日付オブジェクトの文字列表現のフォーマットを指定することができます。

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

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

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

amText : string

12時間時計の慣習で指定された時刻の接尾辞 "AM "のローカライズされた名前。

decimalPoint : string

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

exponential : string

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

firstDayOfWeek : enumeration

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

groupSeparator : string

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

measurementSystem : enumeration

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

name : string

このロケールの言語と領域を "language_territory" という形式の文字列で保持します。 language は小文字の二文字の ISO 639 言語コードで、territory は大文字の二文字あるいは三文字の 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

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

メソッドのドキュメント

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

ロケールで定義されたセパレータを持つ、指定されたlist 文字列の結合を表す文字列を返します。

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

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

string currencySymbol(format)

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

string Number::toLocaleCurrencyString(locale, symbol)も参照 ください。

string dateFormat(type)

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

The Date JavaScript Objectも参照ください 。

string dateTimeFormat(type)

現在のロケールで使われている日付時刻フォーマットを返します。type で返すFormatType を指定します。

The Date JavaScript Objectも参照ください 。

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)

month type で指定された のローカライズされた名前 (0-11) を返します。FormatType

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 を指定します。

The Date JavaScript Objectも参照ください 。

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