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 스크립트 코드입니다,
• 영역은 대문자, 두 글자, ISO 3166 영역 코드(일부 숫자 코드도 인식됨), 그리고
• 코드셋과 수정자는 무시됩니다.

구분 기호는 밑줄 '_' (U+005F, "로우 라인") 또는 대시 '-' (U+002D, "하이픈-마이너스") 중 하나를 사용할 수 있습니다. QLocale에 지정된 언어, 스크립트 및 지역 조합에 대한 데이터가 없는 경우, 대신 찾을 수 있는 가장 적합한 일치 항목을 사용합니다. 문자열이 로캘 형식을 위반하거나 지정된 키에 적합한 데이터를 찾을 수 없는 경우 "C" 로캘이 대신 사용됩니다.

이 생성자는 QLocale(언어, 스크립트, 지역) 또는 QLocale(언어, 지역)보다 훨씬 느립니다.

이 함수는 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)

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

[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 모범 사례 47에 맞추려고 시도합니다. Qt 6.7부터는 선택적 separator 파라미터를 지원하며, 이 파라미터를 사용하여 태그를 구분하는 데 하이픈으로 지정된 BCP47 사용을 재정의할 수 있습니다. 그러나 IETF 정의 프로토콜에서 사용하려면 기본값인 QLocale::TagSeparator::Dash 을 유지해야 합니다.

name(), language(), territory(), script() 및 uiLanguages()도 참조하세요 .

[static] 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" 형식의 문자열로 반환합니다. 여기서 언어는 소문자로 된 두 글자 ISO 639 언어 코드이고 지역은 대문자로 된 두 글자 또는 세 글자 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

로캘에 대한 해당 지역의 기본 이름을 반환합니다. 예를 들어 스페인어/스페인 로캘의 경우 "España"입니다.

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

nativeLanguageName() 및 territoryToString()도 참조하세요 .

QString QLocale::negativeSign() const

이 로캘의 음수 부호 표시기를 반환합니다.

이것은 숫자가 음수임을 나타내기 위해 숫자의 접두사로 사용되는 것으로 추정되는 토큰입니다. 일부 로캘에서는 텍스트 방향 제어 문자를 포함하는 등 단일 문자가 아니기 때문에 (Qt 6.0 이후) 문자열로 반환됩니다.

positiveSign() 및 toString()도 참조하세요 .

QLocale::NumberOptions QLocale::numberOptions() const

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

기본적으로 OmitGroupSeparator 이 설정되어 있는 "C" 로캘을 제외한 표준 로캘에는 기본적으로 설정된 옵션이 없습니다.

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

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

로캘 정보에 독립형 요일 이름이 지정되지 않은 경우 반환 값은 dayName()에서와 동일합니다.

dayName() 및 standaloneMonthName()도 참조하세요 .

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

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

로캘 정보에 독립형 월 이름이 지정되지 않은 경우 반환 값은 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

이 함수는 toCurrencyString()을 오버로드합니다.

value 의 현지화된 문자열 표현을 통화로 반환합니다. symbol 이 제공되면 기본 통화 기호 대신 사용됩니다. precision 을 제공하면 통화 값의 정밀도를 설정하는 데 사용됩니다.

currencySymbol()도 참조하세요 .

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

이 함수는 toCurrencyString()을 오버로드합니다.

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

주어진 format 에서 string 을 날짜로 읽습니다.

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

주어진 format 에서 string 을 날짜/시간으로 읽습니다.

string 을 구문 분석하여 해당 날짜-시간을 반환합니다. format 의 해석은 QDateTime::fromString()를 참조하세요.

format 이 연도의 마지막 두 자리 숫자만 지정하는 경우 baseYear 에서 시작하는 100년이 가장 먼저 고려되는 후보입니다. 6.7 이전에는 baseYear 매개변수가 없었으며 항상 1900이 사용되었습니다. baseYear 의 기본값은 그때부터 1999년까지 연도를 선택하는 것입니다. 경우에 따라 주어진 모든 필드와 일치하는 결과를 얻기 위해 다른 필드가 다음 세기 또는 이전 세기를 선택하게 될 수도 있습니다. 자세한 내용은 QDate::fromString()를 참조하세요.

문자열을 구문 분석할 수 없으면 잘못된 QDateTime 을 반환합니다. 문자열을 구문 분석할 수 있고 잘못된 날짜/시간을 나타내는 경우(예: 시간대 전환으로 건너뛴 간격) 잘못된 QDateTime 이 반환되며, toMSecsSinceEpoch()는 유효한 가까운 날짜/시간을 나타냅니다. 이를 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 으로 표현되는 배수를 반환합니다.

변환이 오버플로되면 무한대를 반환하고, 다른 이유(예: 언더플로)로 변환이 실패하면 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 으로 표현되는 배수를 반환합니다.

변환이 오버플로되면 무한대를 반환하고, 다른 이유(예: 언더플로)로 변환이 실패하면 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 로 표현되는 정수를 반환합니다.

변환이 오버플로되면 무한대를 반환하고, 다른 이유(예: 언더플로)로 변환이 실패하면 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 로 설정하여 보고합니다.

이 함수는 선행 및 후행 공백을 무시합니다.

toDouble(), toInt() 및 toString()도 참조하세요 .

int QLocale::toInt(QStringView s, bool *ok = nullptr) const

지역화된 문자열 s 으로 표현되는 정수를 반환합니다.

변환에 실패하면 함수는 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

이 함수는 선행 및 후행 공백을 무시합니다.

toUInt() 및 toString()도 참조하세요 .

int QLocale::toInt(const QString &s, bool *ok = nullptr) const

지역화된 문자열 s 로 표시되는 정수를 반환합니다.

변환에 실패하면 함수는 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

이 함수는 선행 및 후행 공백을 무시합니다.

toUInt() 및 toString()도 참조하세요 .

long QLocale::toLong(QStringView s, bool *ok = nullptr) const

지역화된 문자열 s 로 표현되는 긴 정수를 반환합니다.

변환에 실패하면 함수는 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

이 함수는 선행 및 후행 공백을 무시합니다.

toInt(), toULong(), toDouble() 및 toString()도 참조하세요 .

long QLocale::toLong(const QString &s, bool *ok = nullptr) const

지역화된 문자열 s 로 표현되는 긴 정수를 반환합니다.

변환에 실패하면 함수는 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

이 함수는 선행 및 후행 공백을 무시합니다.

toInt(), toULong(), toDouble() 및 toString()도 참조하세요 .

qlonglong QLocale::toLongLong(QStringView s, bool *ok = nullptr) const

지역화된 문자열 s 로 표현되는 긴 긴 인트를 반환합니다.

변환에 실패하면 함수는 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

이 함수는 선행 및 후행 공백을 무시합니다.

toInt(), toULongLong(), toDouble() 및 toString()도 참조하세요 .

qlonglong QLocale::toLongLong(const QString &s, bool *ok = nullptr) const

지역화된 문자열 s 로 표현되는 긴 긴 정수를 반환합니다.

변환에 실패하면 함수는 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

이 함수는 선행 및 후행 공백을 무시합니다.

toInt(), toULongLong(), toDouble() 및 toString()도 참조하세요 .

QString QLocale::toLower(const QString &str) const

str 의 소문자 사본을 반환합니다.

Qt Core 에서 ICU 라이브러리를 사용하는 경우 현재 로캘의 규칙에 따라 변환을 수행하는 데 사용됩니다. 그렇지 않으면 QString::toLower()를 일반 대체값으로 사용하여 플랫폼에 따라 변환이 수행될 수 있습니다.

QString::toLower()도 참조하세요 .

short QLocale::toShort(QStringView s, bool *ok = nullptr) const

지역화된 문자열 s 으로 표현되는 짧은 int를 반환합니다.

변환에 실패하면 함수는 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

이 함수는 선행 및 후행 공백을 무시합니다.

toUShort() 및 toString()도 참조하세요 .

short QLocale::toShort(const QString &s, bool *ok = nullptr) const

지역화된 문자열 s 로 표현되는 짧은 정수를 반환합니다.