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() 함수를 통해서만 만들 수 있습니다. 직접 생성할 수 없습니다.

Qt.locale() 함수는 지정된 이름의 로캘을 나타내는 JS 로캘 객체를 반환하며, 형식은 "language[_territory][.codeset][@modifier]" 또는 "C"입니다.

로캘은 애플리케이션 시작 시 시스템의 로캘 설정에 따라 결정되는 기본 로캘 개념을 지원합니다. Qt.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 로캘의 데이터는 공통 로캘 데이터 리포지토리 v1.8.1을 기반으로 합니다.

로캘 문자열 형식 유형

monthName(), standaloneMonthName(), dayName() 및 standaloneDayName()는 다음 열거형 값을 사용하여 Date 개체에 대한 문자열 표현의 서식을 지정할 수 있습니다.

Constant	설명
`Locale.LongFormat`	일 및 월 이름의 긴 버전(예: 월 이름으로 '1월'을 반환)입니다.
`Locale.ShortFormat`	일 및 월 이름의 짧은 버전(예: 월 이름으로 "Jan"을 반환)입니다.
`Locale.NarrowFormat`	공간이 제한되어 있을 때 사용하기 위한 일 및 월 이름의 특수 버전(예: 월 이름으로 "J"를 반환)입니다. 로캘이 좁은 이름을 지원하지 않는 경우 좁은 형식은 다른 월과 일에 대해 동일한 텍스트를 포함하거나 빈 문자열이 될 수도 있으므로 날짜 형식에 사용하지 않아야 합니다. 또한 시스템 로캘의 경우 이 형식은 ShortFormat과 동일합니다.

또한 이중에서 문자열로 및 문자열에서 이중으로 변환하는 함수는 다음 라이선스가 적용됩니다:

이 소프트웨어의 사본 또는 수정본이 포함되거나 포함된 모든 소프트웨어의 모든 사본과 해당 소프트웨어에 대한 지원 문서의 모든 사본에 이 전체 고지가 포함되는 경우, 어떠한 목적으로든 이 소프트웨어를 수수료 없이 사용, 복사, 수정 및 배포할 수 있는 권한이 부여됩니다.

본 소프트웨어는 어떠한 명시적 또는 묵시적 보증 없이 "있는 그대로" 제공됩니다. 특히, 저자나 AT&T는 이 소프트웨어의 상품성 또는 특정 목적에의 적합성과 관련하여 어떠한 종류의 진술이나 보증도 하지 않습니다.

이 제품에는 캘리포니아 대학교 버클리 캠퍼스 및 그 기여자가 개발한 소프트웨어가 포함되어 있습니다.

Date 및 Number 을참조하세요 .

속성 문서

amText : string

12시간 시계의 규칙을 사용하여 지정된 시간에 대한 "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

참고: 이 값은 Qt C++ API( Qt::Sunday = 7)와는 다른 JS Date API와 일치합니다.

groupSeparator : string

이 로캘의 그룹 구분 문자를 보유합니다.

measurementSystem : enumeration

이 프로퍼티는 측정에 사용되는 단위를 정의합니다.

Constant	설명
`Locale.MetricSystem`	이 값은 미터, 센티미터, 밀리미터와 같은 미터법 단위를 나타냅니다.
`Locale.ImperialUSSystem`	이 값은 미국에서 사용되는 인치 및 마일과 같은 영국식 단위를 나타냅니다.
`Locale.ImperialUKSystem`	이 값은 영국에서 사용되는 인치 및 마일과 같은 영국식 단위를 나타냅니다.
`Locale.ImperialSystem`	호환성을 위해 제공됩니다. Locale.ImperialUSSystem과 동일합니다.

name : string

이 로캘의 언어 및 지역을 "language_territory" 형식의 문자열로 보유하며, 여기서 언어는 소문자로 된 두 글자 ISO 639 언어 코드이고 지역은 대문자로 된 두 글자 또는 세 글자 ISO 3166 지역 코드입니다.

nativeLanguageName : string

로캘에 대한 언어의 고유 이름을 보유합니다. 예를 들어 스위스-독일 로캘의 경우 "Schwiizertüütsch"입니다.

nativeTerritoryName 를참조하세요 .

nativeTerritoryName : string

로캘에 대한 해당 지역의 고유 이름을 보유합니다. 예: 스페인어/스페인 로캘의 경우 "España".

nativeLanguageName 를참조하세요 .

negativeSign : string

이 로캘의 음수 부호 문자를 보유합니다.

numberOptions : enumeration

숫자에서 문자열로 및 문자열에서 숫자로 변환하기 위한 옵션 집합을 보유합니다.

Number::toLocaleString() 및 Number::fromLocaleString()도 참조하세요 .

percent : string

이 로캘의 퍼센트 문자를 보유합니다.

pmText : string

12시간 시계의 규칙을 사용하여 지정된 시간에 대한 "PM" 접미사의 현지화된 이름입니다.

positiveSign : string

이 로캘의 양수 부호 문자를 보유합니다.

textDirection : enumeration

언어의 텍스트 방향을 보유합니다:

상수	설명
`Qt.LeftToRight`	텍스트는 일반적으로 왼쪽에서 시작합니다.
`Qt.RightToLeft`	텍스트는 일반적으로 오른쪽에서 시작합니다.

uiLanguages : Array<string>

기본 설정 순서에 따라 번역을 위한 로캘 이름의 정렬된 목록을 반환합니다.

반환 값은 사용자가 UI 번역을 볼 것으로 예상하는 로캘 이름을 나타냅니다.

목록의 첫 번째 항목이 가장 선호되는 항목입니다.

weekDays : Array<int>

현재 로캘에 따라 요일로 간주되는 요일 배열을 보유하며, 일요일은 0이고 토요일은 6입니다.

firstDayOfWeek 를참조하세요 .

zeroDigit : string

홀드 이 로캘의 0자리 문자를 반환합니다.

메서드 문서

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)

day (여기서 0은 일요일, 1은 월요일 등)의 현지화된 이름을 type 에서 지정한 선택적 FormatType 으로 반환합니다.

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 (0-11)의 지역화된 이름을 type 에 지정된 FormatType 옵션으로 반환합니다.

참고: 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.