QLocale Class

멤버 함수 설명서

QLocale::QLocale()

기본 로케일로 초기화된 QLocale 객체를 생성합니다.

setDefault()를 사용하여 기본 로캘이 설정되지 않은 경우, 이 로캘은 system()가 반환하는 로캘과 동일합니다.

setDefault() 및 system()도 참조하십시오 .

[explicit, since 6.3] QLocale::QLocale(QStringView name)

지정된 name 를 사용하여 QLocale 객체를 생성합니다.

이름의 형식은 "language[_script][_territory][.codeset][@modifier]" 또는 "C"이며, 여기서:

• language는 소문자 2글자짜리 ISO 639 언어 코드입니다(일부 3글자 코드도 인식됨).
• script는 대문자로 표기된 4글자 ISO 15924 문자 체계 코드이며,
• territory는 대문자 2글자 ISO 3166 지역 코드이며(일부 숫자 코드도 인식됨),
• codeset과 modifier는 무시됩니다.

구분 기호로는 밑줄 '_' (U+005F, "low line") 또는 대시 '-' (U+002D, "hyphen-minus")를 사용할 수 있습니다. QLocale에 지정된 언어, 문자 체계 및 지역 조합에 대한 데이터가 없는 경우, 대신 찾을 수 있는 가장 적합한 항목을 사용합니다. 문자열이 로케일 형식을 위반하거나 지정된 키에 대해 적합한 데이터를 찾을 수 없는 경우, 대신 "C" 로케일이 사용됩니다.

이 생성자는 QLocale(Language, Script, Territory) 또는 QLocale(Language, Territory)보다 훨씬 느립니다.

이 함수는 Qt 6.3에서 도입되었습니다.

bcp47Name() 및 Matching combinations of language, script and territory도 참조하십시오 .

QLocale::QLocale(QLocale::Language language, QLocale::Territory territory)

지정된 ` language ` 및 ` territory`에 대한 `QLocale` 객체를 생성합니다.

이 조합에 대해 사용 중인 스크립트가 두 개 이상인 경우, 가장 적합한 스크립트가 선택됩니다. QLocale에 지정된 language 에 대한 데이터가 없는 경우, 기본 로케일이 사용됩니다. QLocale에 지정된 language 와 territory 의 조합에 대한 데이터가 없는 경우, 대신 대체 지역이 사용될 수 있습니다.

setDefault() 및 Matching combinations of language, script and territory도 참조하십시오 .

QLocale::QLocale(QLocale::Language language, QLocale::Script script = AnyScript, QLocale::Territory territory = AnyTerritory)

지정된 language, script 및 territory 에 대한 QLocale 객체를 생성합니다.

QLocale에 주어진 조합에 대한 데이터가 없는 경우, 가능한 한 가장 근접한 데이터를 찾아옵니다.

• language AnyLanguage 인 경우, 에서 언어를 추론할 수 없고 script territory
• language 로 지정되었거나 위와 같이 추론된 언어에 대해 QLocale에 데이터가 없는 경우, 기본 로케일을 사용합니다.

setDefault() 및 Matching combinations of language, script and territory도 참조하십시오 .

[explicit] QLocale::QLocale(const QString &name)

[noexcept] QLocale::QLocale(const QLocale &other)

other 의 복사본으로 QLocale 객체를 생성합니다.

[noexcept] QLocale::~QLocale()

소멸자

QString QLocale::amText() const

12시간제 표기법을 사용하여 지정된 시간의 “AM” 접미사에 대한 현지화된 이름을 반환합니다.

pmText()도 참조하십시오 .

QString QLocale::bcp47Name(QLocale::TagSeparator separator = TagSeparator::Dash) const

대시(-)로 연결된 BCP47 필드 이름을 반환합니다.

이는 해당 로케일을 고유하게 지정하는 데 필요한 만큼의 언어, 문자 체계 및 지역(그리고 다른 BCP47 필드도 포함될 수 있음)을 결합한 것입니다. 유니코드 컨소시엄의 Likely Subtag Rules 에 따라, 유지된 필드만 주어졌을 때 생략된 필드가 암시적으로 포함된다고 간주되는 경우, 해당 필드는 생략될 수 있습니다. 다른 형식이 필요한 경우 개별 필드에서 문자열을 구성하는 방법은 name()을 참조하십시오.

uiLanguages()와 달리, bcp47Name()이 반환하는 값은 QLocale 데이터의 로케일 이름을 나타내며, 이는 사용자 인터페이스가 사용해야 하는 언어와 반드시 일치할 필요는 없습니다.

이 함수는 로케일 이름을 RFC 5646에 정의된 IETF Best Common Practice 47에 부합하도록 조정하려고 시도합니다. Qt 6.7부터는 선택적 separator 매개변수를 지원하며, 이를 사용하여 BCP47에서 지정된 태그 구분용 하이픈 사용을 재정의할 수 있습니다. 그러나 IETF에서 정의한 프로토콜에서 사용할 경우에는 기본값인 QLocale::TagSeparator::Dash 을 유지해야 합니다.

name(), language(), territory(), script(), uiLanguages()도 참조하십시오 .

[static noexcept] QLocale QLocale::c()

"C" 로케일로 초기화된 ` QLocale ` 객체를 반환합니다.

이 로케일은 en_US를 기반으로 하지만, 단순화된 숫자 서식 및 고유한 날짜 서식과 같은 여러 가지 특징을 가지고 있습니다. 이 로케일은 "C" 프로그래밍 언어의 표준 라이브러리 함수 동작을 설명하는 POSIX 표준을 구현합니다.

이는 무엇보다도 이 로케일의 정렬 순서가 문자의 ASCII 값을 기반으로 함을 의미합니다. 따라서 (대소문자를 구분하는 정렬의 경우) 모든 대문자가 소문자보다 먼저 정렬됩니다(각 문자의 대문자와 소문자 형태가 서로 인접하게 정렬된 후, 다음 문자의 두 형태가 정렬되는 방식과는 다릅니다).

system()도 참조하십시오 .

[static noexcept, since 6.3] QLocale::Language QLocale::codeToLanguage(QStringView languageCode, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

ISO 639 표준에 정의된 대로, 두 글자 또는 세 글자 언어 코드( languageCode)에 해당하는 ` QLocale::Language ` 열거형을 반환합니다.

codeTypes 가 지정된 경우, 변환 시 고려할 코드 집합을 선택합니다. 기본적으로 Qt가 인식하는 모든 코드가 고려됩니다. 코드는 다음 순서대로 일치 여부를 확인합니다: ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3, LegacyLanguageCode.

코드가 유효하지 않거나 인식되지 않는 경우 QLocale::AnyLanguage 가 반환됩니다.

이 함수는 Qt 6.3에서 도입되었습니다.

languageToCode(), codeToTerritory() 및 codeToScript()도 참조하십시오 .

[static noexcept, since 6.1] QLocale::Script QLocale::codeToScript(QStringView scriptCode)

ISO 15924 표준에 정의된 대로, 4글자 문자 집합 scriptCode 에 해당하는 ‘ QLocale::Script ’ 열거형을 반환합니다.

코드가 유효하지 않거나 알려지지 않은 경우 QLocale::AnyScript 가 반환됩니다.

이 함수는 Qt 6.1에서 도입되었습니다.

scriptToCode(), codeToLanguage() 및 codeToTerritory()도 참조하십시오 .

[static noexcept, since 6.2] QLocale::Territory QLocale::codeToTerritory(QStringView territoryCode)

ISO 3166 표준에 정의된 대로, 두 글자 또는 세 자리 숫자 국가 코드( territoryCode)에 해당하는 ` QLocale::Territory ` 열거형을 반환합니다.

코드가 유효하지 않거나 알 수 없는 경우 QLocale::AnyTerritory 가 반환됩니다.

이 함수는 Qt 6.2에서 도입되었습니다.

territoryToCode(), codeToLanguage() 및 codeToScript()도 참조하십시오 .

QLocale QLocale::collation() const

정렬에 사용할 로케일을 반환합니다.

결과는 대개 이 로케일이지만, 시스템 로케일(일반적으로 기본 로케일)의 경우 시스템 정렬 로케일을 반환합니다. 이 결과는 QCollator 의 생성자에 전달하기에 적합합니다.

QCollator도 참조하십시오 .

QString QLocale::createSeparatedList(const QStringList &list) const

주어진 문자열 list 을 로케일에 의해 정의된 구분 기호로 연결한 결과를 나타내는 문자열을 반환합니다.

QString QLocale::currencySymbol(QLocale::CurrencySymbolFormat format = CurrencySymbol) const

format 에 따라 통화 기호를 반환합니다.

QString QLocale::dateFormat(QLocale::FormatType format = LongFormat) const

현재 로케일에 사용되는 날짜 형식을 반환합니다.

format 가 LongFormat 인 경우 형식은 상세하게 표시되며, 그렇지 않은 경우 간략하게 표시됩니다. 예를 들어, en_US 로케일의 LongFormat 는 dddd, MMMM d, yyyy 이고, ShortFormat 는 M/d/yy 입니다.

QDate::toString() 및 QDate::fromString()도 참조하십시오 .

QString QLocale::dateTimeFormat(QLocale::FormatType format = LongFormat) const

현재 로케일에 사용되는 날짜 및 시간 형식을 반환합니다.

format 가 LongFormat 인 경우 형식은 상세하게 표시되며, 그렇지 않은 경우 간략하게 표시됩니다. 예를 들어, en_US 로케일의 LongFormat 는 dddd, MMMM d, yyyy h:mm:ss AP t 이고, ShortFormat 는 M/d/yy h:mm AP 입니다.

QDateTime::toString() 및 QDateTime::fromString()도 참조하십시오 .

QString QLocale::dayName(int day, QLocale::FormatType type = LongFormat) const

day 의 현지화된 이름(여기서 1은 월요일, 2는 화요일 등을 나타냄)을 type 에 지정된 형식으로 반환합니다.

예를 들어, 로케일이 en_US 이고 day 가 1인 경우, LongFormat 는 Monday 를, ShortFormat 는 Mon 를, NarrowFormat 는 M 를 반환합니다.

monthName() 및 standaloneDayName()도 참조하십시오 .

QString QLocale::decimalPoint() const

이 로케일에 해당하는 소수점 구분자를 반환합니다.

이는 소수 부분이 있는 숫자를 표기할 때, 정수 부분과 소수 부분을 구분하는 토큰입니다. 이는 일반적으로 "소수점 문자"라고 불리지만, 많은 로케일에서는 "점"(또는 이와 유사한 기호)이 아닙니다. 일부 로케일에서는 구분자를 표현하는 데 UTF-16 코드 포인트가 두 개 이상 필요한 경우를 대비하여, (Qt 6.0부터) 이 값은 문자열로 반환됩니다.

groupSeparator() 및 toString()도 참조하십시오 .

QString QLocale::exponential() const

이 로케일의 지수 구분자를 반환합니다.

이는 일부 부동 소수점 수 표현에서 맨티사와 지수를 구분하는 데 사용되는 토큰입니다. (Qt 6.0부터) 일부 로케일에서는 이 토큰이 단일 문자가 아니기 때문에(예를 들어, 곱셈 기호와 "10의 제곱" 연산자 표기로 구성될 수 있음) 문자열로 반환됩니다.

toString(double, char, int)도 참조하십시오 .

Qt::DayOfWeek QLocale::firstDayOfWeek() const

현재 로케일에 따라 해당 주의 첫 번째 요일을 반환합니다.

QString QLocale::formattedDataSize(qint64 bytes, int precision = 2, QLocale::DataSizeFormats format = DataSizeIecFormat) const

바이트 단위의 크기를 숫자와 수량 단위로 구성된, 사람이 읽기 쉬운 현지화된 문자열로 변환합니다. 수량 단위는 숫자가 1 이상이 되도록 하면서 가능한 한 작게 선택됩니다. 예를 들어, ` bytes `가 16384이고, ` precision `가 2이며, ` format `가 ` DataSizeIecFormat `(기본값)인 경우, 이 함수는 "16.00 KiB"를 반환합니다. 1330409069609바이트의 경우 "1.21 GiB"를 반환하며, 이와 같은 방식으로 계산됩니다. format 가 DataSizeIecFormat 또는 DataSizeTraditionalFormat 인 경우, 주어진 바이트 수는 1024의 거듭제곱으로 나뉘며, 그 결과는 1024보다 작습니다. DataSizeSIFormat 인 경우, 1000의 거듭제곱으로 나뉘며, 그 결과는 1000보다 작습니다. DataSizeIecFormat 는 새로운 IEC 표준의 수량사 Ki, Mi 등을 사용하는 반면, DataSizeSIFormat 는 구식 SI 수량사 k, M 등을 사용하며, DataSizeTraditionalFormat 는 이를 잘못 사용하고 있습니다.

QString QLocale::groupSeparator() const

이 로케일에 대한 자릿수 구분 기호를 반환합니다.

이는 숫자를 표기할 때 긴 숫자열을 그룹으로 나누어 가독성을 높이기 위해 사용되는 토큰입니다. 일부 로케일에서는 이 값이 비어 있을 수 있으며, 이는 숫자를 이러한 방식으로 그룹으로 나누지 말아야 함을 나타냅니다. 다른 로케일에서는 공백 문자가 될 수도 있습니다. 일부 로케일에서 구분자를 표현하는 데 하나 이상의 UTF-16 코드 포인트가 필요한 경우를 대비하여 (Qt 6.0부터) 문자열로 반환됩니다.

decimalPoint() 및 toString()도 참조하십시오 .

QLocale::Language QLocale::language() const

이 로케일의 언어를 반환합니다.

script(), territory(), languageToString() 및 bcp47Name()도 참조하십시오 .

[static, since 6.3] QString QLocale::languageToCode(QLocale::Language language, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

ISO 639 표준에 정의된 대로 language 에 대한 2자 또는 3자 언어 코드를 반환합니다.

codeTypes 가 지정된 경우, 고려할 코드 집합을 선택합니다. language 에 대해 정의된 집합 중 첫 번째 코드가 반환됩니다. 그렇지 않은 경우, 모든 ISO-639 코드가 고려됩니다. 코드는 다음 순서대로 고려됩니다: ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3. LegacyLanguageCode 는 이 함수에서 무시됩니다.

이 함수는 Qt 6.3에서 도입되었습니다.

참조: codeToLanguage(), language(), name(), bcp47Name(), territoryToCode() 및 scriptToCode().

[static] QString QLocale::languageToString(QLocale::Language language)

language 의 이름을 포함하는 QString 객체를 반환합니다.

territoryToString(), scriptToString(), bcp47Name()도 참조하십시오 .

[static] QList<QLocale> QLocale::matchingLocales(QLocale::Language language, QLocale::Script script, QLocale::Territory territory)

주어진 language, script 및 territory 에 일치하는 유효한 로케일 객체 목록을 반환합니다.

모든 로케일 목록 가져오기: QList<QLocale> allLocales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::AnyTerritory);

러시아에 적합한 로케일 목록 가져오기: QList<QLocale> locales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::Russia);

QLocale::MeasurementSystem QLocale::measurementSystem() const

해당 로캘의 측정 단위를 반환합니다.

QString QLocale::monthName(int month, QLocale::FormatType type = LongFormat) const

month 의 현지화된 이름을 type 에서 지정된 형식으로 반환합니다.

예를 들어, 로케일이 en_US 이고 month 가 1인 경우, LongFormat 는 January 를 반환합니다. ShortFormat 는 Jan 를, NarrowFormat 는 J 를 반환합니다.

dayName() 및 standaloneMonthName()도 참조하십시오 .

QString QLocale::name(QLocale::TagSeparator separator = TagSeparator::Underscore) const

이 로케일의 약칭입니다.

이 로케일의 언어와 지역을 "language_territory" 형식의 문자열로 반환합니다. 여기서 language는 소문자 2글자 ISO 639 언어 코드이며, territory는 대문자 2~3글자 ISO 3166 지역 코드입니다. 로케일에 지정된 지역이 없는 경우, 언어 이름만 반환됩니다. Qt 6.7부터는 선택적 매개변수인 separator 를 지정하여 두 태그를 구분하는 기본 언더스코어(_) 문자를 재정의할 수 있습니다.

QLocale 객체가 명시적인 스크립트로 생성된 경우라도, 호환성상의 이유로 name()에는 해당 스크립트가 포함되지 않습니다. 전체 로케일 이름이 필요한 경우 대신 bcp47Name()을 사용하거나, language()을 languageToCode()에 전달하여 반환된 값을 바탕으로 로케일을 식별할 문자열을 구성하십시오. 스크립트 및 테리토리의 경우에도 이와 유사한 방법을 사용하십시오.

QLocale(), language(), script(), territory(), bcp47Name(), uiLanguages()도 참조하십시오 .

QString QLocale::nativeLanguageName() const

해당 로케일의 언어에 대한 현지 언어로 된 이름을 반환합니다. 예를 들어, 스위스 독일어 로케일의 경우 "Schweizer Hochdeutsch"를 반환합니다.

nativeTerritoryName() 및 languageToString()도 참조하십시오 .

[since 6.2] QString QLocale::nativeTerritoryName() const

지정된 로케일에 해당하는 지역의 현지 언어로 된 이름을 반환합니다. 예를 들어, Spanish/Spain 로케일의 경우 "España"를 반환합니다.

이 함수는 Qt 6.2에서 도입되었습니다.

nativeLanguageName() 및 territoryToString()도 참조하십시오 .

QString QLocale::negativeSign() const

이 로케일의 음수 표시기를 반환합니다.

이 토큰은 숫자 앞에 붙여 음수임을 나타내는 데 사용되는 것으로 간주됩니다. 일부 로케일에서는(예: 텍스트 방향 제어 문자가 포함되어 있는 경우) 단일 문자가 아니기 때문에, Qt 6.0부터는 문자열로 반환됩니다.

positiveSign() 및 toString()도 참조하십시오 .

QLocale::NumberOptions QLocale::numberOptions() const

이 QLocale 인스턴스의 숫자 변환과 관련된 옵션을 반환합니다.

기본적으로 표준 로케일에 대해서는 옵션이 설정되어 있지 않으며, “C” 로케일만 예외로, 이 로케일에는 기본적으로 OmitGroupSeparator 가 설정되어 있습니다.

setNumberOptions(), toString(), groupSeparator(), FloatingPointPrecisionOption도 참조하십시오 .

QString QLocale::percent() const

이 로케일의 백분율 기호를 반환합니다.

이 토큰은 숫자 뒤에 붙여져 백분율을 나타내는 것으로 간주됩니다. 일부 로케일에서는(예를 들어, 텍스트 방향 제어 문자가 포함되어 있는 경우) 단일 문자가 아니기 때문에(Qt 6.0부터) 문자열로 반환됩니다.

toString()도 참조하십시오 .

QString QLocale::pmText() const

12시간제 표기법을 사용하여 지정된 시간의 “PM” 접미사에 대한 현지화된 이름을 반환합니다.

amText()도 참조하십시오 .

QString QLocale::positiveSign() const

이 로케일의 양수 표시자를 반환합니다.

이 토큰은 숫자 앞에 접두사로 사용되어 해당 숫자가 양수임을 나타내는 것으로 간주됩니다. 일부 로케일에서는(예: 텍스트 방향 제어 문자가 포함되어 있는 경우) 단일 문자가 아니기 때문에, (Qt 6.0부터) 문자열로 반환됩니다.

negativeSign() 및 toString()도 참조하십시오 .

QString QLocale::quoteString(const QString &str, QLocale::QuotationStyle style = StandardQuotation) const

지정된 인용 방식 style 을 사용하여 현재 로케일에 따라 인용된 ` str `를 반환합니다.

[since 6.0] QString QLocale::quoteString(QStringView str, QLocale::QuotationStyle style = StandardQuotation) const

이 함수는 Qt 6.0에서 도입되었습니다.

QLocale::Script QLocale::script() const

이 로케일의 스크립트를 반환합니다.

language(), territory(), languageToString(), scriptToString(), bcp47Name()도 참조하십시오 .

[static, since 6.1] QString QLocale::scriptToCode(QLocale::Script script)

ISO 15924 표준에 정의된 대로 ‘ script ’에 해당하는 4글자 스크립트 코드를 반환합니다.

이 함수는 Qt 6.1에서 도입되었습니다.

script(), name(), bcp47Name(), languageToCode() 및 territoryToCode()도 참조하십시오 .

[static] QString QLocale::scriptToString(QLocale::Script script)

script 의 이름을 포함하는 QString 를 반환합니다.

languageToString(), territoryToString(), script(), bcp47Name()도 참조하십시오 .

[static] void QLocale::setDefault(const QLocale &locale)

전역 기본 로케일을 locale 로 설정합니다.

이 로케일은 인수를 지정하지 않고 QLocale 객체를 생성할 때 사용됩니다. 이 함수가 호출되지 않으면 시스템의 로케일이 사용됩니다.

경고: 이 함수는 재진입 가능하지 않습니다.

system() 및 c()도 참조하십시오 .

void QLocale::setNumberOptions(QLocale::NumberOptions options)

이 QLocale 인스턴스의 숫자 변환과 관련된 options 를 설정합니다.

numberOptions() 및 FloatingPointPrecisionOption도 참조하십시오 .

QString QLocale::standaloneDayName(int day, QLocale::FormatType type = LongFormat) const

type 에서 지정한 형식에 따라, 독립된 텍스트로 사용되는 ‘ day ’의 현지화된 이름을 반환합니다(여기서 1은 월요일, 2는 화요일 등을 나타냅니다).

로케일 정보에 독립형 요일명이 지정되어 있지 않은 경우, 반환 값은 dayName()에서 반환되는 값과 동일합니다.

dayName() 및 standaloneMonthName()도 참조하십시오 .

QString QLocale::standaloneMonthName(int month, QLocale::FormatType type = LongFormat) const

type 에서 지정한 형식에 따라, 독립된 텍스트로 사용되는 month 의 현지화된 이름을 반환합니다.

로케일 정보에 독립형 월명이 지정되어 있지 않은 경우, 반환값은 monthName()의 반환값과 동일합니다.

monthName() 및 standaloneDayName()도 참조하십시오 .

[noexcept] void QLocale::swap(QLocale &other)

현재 로케일을 other 로 변경합니다. 이 작업은 매우 빠르며 실패하는 일이 없습니다.

[static] QLocale QLocale::system()

시스템 로케일로 초기화된 QLocale 객체를 반환합니다.

시스템 로케일은 가능한 경우 시스템 고유의 로케일 데이터 소스를 사용할 수 있으며, 그렇지 않은 경우 시스템이 보고하는 언어, 문자 체계 및 지역에 대해 ` QLocale`의 내장 데이터베이스 항목을 대신 사용합니다.

예를 들어, Windows 및 Mac에서는 이 로케일이 시스템 구성 패널에 지정된 소수점/그룹화 문자와 날짜/시간 형식을 사용합니다.

c()도 참조하십시오 .

[since 6.2] QLocale::Territory QLocale::territory() const

이 로케일의 영역을 반환합니다.

이 함수는 Qt 6.2에서 도입되었습니다.

language(), script(), territoryToString(), bcp47Name()도 참조하십시오 .

[static, since 6.2] QString QLocale::territoryToCode(QLocale::Territory territory)

ISO 3166 표준에 정의된 대로 territory 의 두 글자 지역 코드를 반환합니다.

이 함수는 Qt 6.2에서 도입되었습니다.

참조: codeToTerritory(), territory(), name(), bcp47Name(), languageToCode(), scriptToCode().

[static, since 6.2] QString QLocale::territoryToString(QLocale::Territory territory)

territory 의 이름을 포함하는 QString 객체를 반환합니다.

이 함수는 Qt 6.2에서 도입되었습니다.

languageToString(), scriptToString(), territory(), bcp47Name()도 참조하십시오 .

Qt::LayoutDirection QLocale::textDirection() const

해당 언어의 텍스트 방향을 반환합니다.

QString QLocale::timeFormat(QLocale::FormatType format = LongFormat) const

현재 로케일에 사용되는 시간 형식을 반환합니다.

format 가 LongFormat 인 경우 형식은 상세하게 표시되며, 그렇지 않은 경우 간략하게 표시됩니다. 예를 들어, en_US 로케일의 경우 LongFormat 는 h:mm:ss AP t 이며, ShortFormat 는 h:mm AP 입니다.

QTime::toString() 및 QTime::fromString()도 참조하십시오 .

QString QLocale::toCurrencyString(qlonglong value, const QString &symbol = QString()) const

value 를 통화로 변환한 지역화된 문자열을 반환합니다. symbol 가 제공되면 기본 통화 기호 대신 해당 기호가 사용됩니다.

currencySymbol()도 참조하십시오 .

QString QLocale::toCurrencyString(int value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(qulonglong value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(short value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(uint value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(ushort value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(double value, const QString &symbol = QString(), int precision = -1) const

value 의 지역화된 문자열 표현을 통화 형식으로 반환합니다. symbol 가 지정된 경우, 기본 통화 기호 대신 해당 기호가 사용됩니다. precision 가 지정된 경우, 이를 사용하여 통화 값의 소수점 자릿수를 설정합니다.

currencySymbol()도 참조하십시오 .

QString QLocale::toCurrencyString(float i, const QString &symbol = QString(), int precision = -1) const

QDate QLocale::toDate(const QString &string, QLocale::FormatType format = LongFormat, int baseYear = DefaultTwoDigitBaseYear) const

string 을 로케일별 format 형식의 날짜로 해석합니다.

string 을 구문 분석하여 해당 날짜를 반환합니다. 날짜 문자열의 형식은 format 매개변수에 따라 결정됩니다( dateFormat() 참조).

일부 로케일에서는, 특히 ShortFormat 의 경우, 연도의 마지막 두 자리만 사용합니다. 이러한 경우, baseYear 부터 시작하는 100년 단위가 우선적으로 고려됩니다. 6.7 이전 버전에서는 baseYear 매개변수가 없었으며, 항상 1900년이 사용되었습니다. 이는 baseYear 의 기본값으로, 해당 연도부터 1999년까지의 연도 중 하나를 선택합니다. 경우에 따라, 제공된 모든 필드와 일관된 결과를 얻기 위해 다른 필드에 따라 다음 세기나 이전 세기가 선택될 수도 있습니다. 자세한 내용은 QDate::fromString()을 참조하십시오.

날짜를 파싱할 수 없는 경우, 유효하지 않은 날짜를 반환합니다.

dateFormat(), toTime(), toDateTime() 및 QDate::fromString()도 참조하십시오 .

QDate QLocale::toDate(const QString &string, const QString &format, int baseYear = DefaultTwoDigitBaseYear) const

string 을 지정된 format 에 따라 날짜로 해석합니다.

string 을 구문 분석하여 이를 나타내는 날짜를 반환합니다. format 의 해석에 대해서는 QDate::fromString()을 참조하십시오.

format 가 연도의 마지막 두 자리만 지정하는 경우, baseYear 에서 시작하는 100년 단위의 연도들이 우선적으로 고려됩니다. 6.7 이전 버전에서는 baseYear 매개변수가 없었으며 항상 1900년이 사용되었습니다. 이는 baseYear 의 기본값으로, 해당 연도부터 1999년까지의 연도를 선택합니다. 경우에 따라 다른 필드 값에 따라 모든 입력 필드와 일관된 결과를 얻기 위해 다음 세기나 이전 세기가 선택될 수도 있습니다. 자세한 내용은 QDate::fromString()을 참조하십시오.

날짜를 파싱할 수 없는 경우, 유효하지 않은 날짜를 반환합니다.

dateFormat(), toTime(), toDateTime(), QDate::fromString()도 참조하십시오 .

QDate QLocale::toDate(const QString &string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDate QLocale::toDate(const QString &string, const QString &format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format = LongFormat, int baseYear = DefaultTwoDigitBaseYear) const

string 를 로케일별 format 형식의 날짜-시간으로 해석합니다.

string 을 구문 분석하여 이를 나타내는 날짜-시간을 반환합니다. 날짜 문자열의 형식은 format 매개변수에 따라 결정됩니다( dateFormat() 참조).

일부 로케일에서는, 특히 ShortFormat 의 경우, 연도의 마지막 두 자리만 사용합니다. 이러한 경우, baseYear 부터 시작하는 100년 단위가 우선적으로 고려됩니다. 6.7 이전 버전에서는 baseYear 매개변수가 없었으며 항상 1900년이 사용되었습니다. 이는 baseYear 의 기본값으로, 해당 연도부터 1999년까지의 연도 중 하나를 선택합니다. 경우에 따라, 제공된 모든 필드와 일관된 결과를 얻기 위해 다른 필드에 따라 다음 세기나 이전 세기가 선택될 수도 있습니다. 자세한 내용은 QDate::fromString()을 참조하십시오.

문자열을 구문 분석할 수 없는 경우, 유효하지 않은 QDateTime 값을 반환합니다.

dateTimeFormat(), toTime(), toDate(), QDateTime::fromString()도 참조하십시오 .

QDateTime QLocale::toDateTime(const QString &string, const QString &format, int baseYear = DefaultTwoDigitBaseYear) const

string 를 지정된 format 의 날짜-시간 형식으로 해석합니다.

string 를 파싱하여 해당 값이 나타내는 날짜 및 시간을 반환합니다. format 의 해석에 대해서는 QDateTime::fromString()을 참조하십시오.

format 가 연도의 마지막 두 자리만 지정하는 경우, baseYear 부터 시작하는 100년 기간이 우선적으로 고려됩니다. 6.7 이전 버전에서는 baseYear 매개변수가 없었으며 항상 1900년이 사용되었습니다. 이는 baseYear 의 기본값으로, 해당 연도부터 1999년까지의 연도를 선택합니다. 경우에 따라 다른 필드 정보에 따라 모든 입력 필드와 일관된 결과를 얻기 위해 다음 세기나 이전 세기가 선택될 수도 있습니다. 자세한 내용은 QDate::fromString()을 참조하십시오.

문자열을 구문 분석할 수 없는 경우, 유효하지 않은 QDateTime 를 반환합니다. 문자열을 구문 분석할 수 있지만 유효하지 않은 날짜-시간(예: 시간대 전환으로 인해 건너뛴 간격)을 나타내는 경우, 반환된 QDateTime 는 유효한 가장 가까운 날짜-시간을 나타냅니다(일반적으로 유효한 날짜-시간의 간격만큼, 예: 전환으로 인해 건너뛴 시간만큼 차이가 납니다). 이를 fromMSecsSinceEpoch()에 전달하면, 구문 분석된 문자열이 정확히 나타내지 않는 유효한 날짜-시간 값이 생성됩니다.

dateTimeFormat(), toTime(), toDate(), QDateTime::fromString()함수도 참조하십시오 .

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDateTime QLocale::toDateTime(const QString &string, const QString &format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

double QLocale::toDouble(QStringView s, bool *ok = nullptr) const

s 라는 지역화된 문자열이 나타내는 double 값을 반환합니다.

변환 시 오버플로가 발생하면 무한대(infinity)를 반환하고, 그 외의 다른 이유(예: 언더플로우)로 변환에 실패하면 0.0을 반환합니다.

ok 가 nullptr 가 아닌 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble(u"1234.56", &ok);  // ok == true,  d == 1234.56
d = c.toDouble(u"1,234.56", &ok); // ok == true,  d == 1234.56
d = c.toDouble(u"1234,56", &ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble(u"1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble(u"1.234,56", &ok); // ok == true,  d == 1234.56
d = german.toDouble(u"1234.56", &ok);  // ok == false, d == 0

d = german.toDouble(u"1.234", &ok);    // ok == true,  d == 1234.0

마지막 변환 결과는 1234.0을 반환한다는 점에 유의하십시오. 이는 독일어 로케일에서 '.'가 천 단위 구분자이기 때문입니다.

이 함수는 앞뒤의 공백을 무시합니다.

toFloat(), toInt() 및 toString()도 참조하십시오 .

double QLocale::toDouble(const QString &s, bool *ok = nullptr) const

s 라는 지역화된 문자열이 나타내는 double 값을 반환합니다.

변환 시 오버플로우가 발생하면 무한대를 반환하고, 그 외의 이유(예: 언더플로우)로 변환에 실패하면 0.0을 반환합니다.

ok 가 nullptr 가 아닌 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble("1234.56", &ok);  // ok == true,  d == 1234.56
d = c.toDouble("1,234.56", &ok); // ok == true,  d == 1234.56
d = c.toDouble("1234,56", &ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble("1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble("1.234,56", &ok); // ok == true,  d == 1234.56
d = german.toDouble("1234.56", &ok);  // ok == false, d == 0

d = german.toDouble("1.234", &ok);    // ok == true,  d == 1234.0

마지막 변환 결과는 1234.0을 반환한다는 점에 유의하십시오. 독일어 로케일에서는 '.'가 천 단위 구분자이기 때문입니다.

이 함수는 앞뒤의 공백을 무시합니다.

toFloat(), toInt() 및 toString()도 참조하십시오 .

float QLocale::toFloat(QStringView s, bool *ok = nullptr) const

s 라는 지역화된 문자열이 나타내는 float 값을 반환합니다.

변환 시 오버플로우가 발생하면 무한대를 반환하고, 그 외의 이유(예: 언더플로우)로 변환에 실패하면 0.0을 반환합니다.

ok 가 nullptr 가 아닌 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

이 함수는 앞뒤의 공백을 무시합니다.

toDouble(), toInt(), toString()함수도 참조하십시오 .

float QLocale::toFloat(const QString &s, bool *ok = nullptr) const

s 라는 지역화된 문자열이 나타내는 부동 소수점 값을 반환합니다.

변환 시 오버플로가 발생하면 무한대를 반환하고, 그 외의 이유(예: 언더플로우)로 변환에 실패하면 0.0을 반환합니다.

ok 가 nullptr 가 아닌 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

이 함수는 앞뒤의 공백을 무시합니다.