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-to-string 및 string-to-double 변환 함수는 다음 라이선스의 적용을 받습니다:

'Date' 자바스크립트 객체 와 'Number' 자바스크립트 객체도 참조하십시오 .

속성 문서

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 이 로케일의 0 자릿수 문자를 반환합니다.

메서드 문서

[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 `를 지정합니다.

자바스크립트 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에서 도입되었습니다.