QTimeZone Class

멤버 함수 문서

UTC보다 앞선 고정된 offset, 초 단위의 시간 표현을 반환합니다.

UTC의 offset 는 -16시간에서 +16시간 범위여야 하며, 그렇지 않으면 잘못된 표준 시간대가 반환됩니다. 반환된 QTimeZone 은 시간대가 아닌 경량 시간 표현(시스템 제공 또는 표준 데이터에 의해 뒷받침됨)입니다.

오프셋이 0이면 반환된 인스턴스의 timeSpec()는 Qt::UTC 입니다. 그렇지 않고 offset 가 유효하면 timeSpec()는 Qt::OffsetFromUTC 입니다. 유효하지 않은 시간대가 반환되면 timeSpec()는 Qt::TimeZone 입니다.

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

QTimeZone(int), asBackendZone(), fixedSecondsAheadOfUtc(), MinUtcOffsetSecs, 및 MaxUtcOffsetSecs도 참조하십시오 .

[noexcept] QTimeZone::QTimeZone()

널/무효 시간대 인스턴스를 생성합니다.

[noexcept, since 6.5] QTimeZone::QTimeZone(QTimeZone::Initialization spec)

UTC 또는 현지 시간을 설명하는 경량 인스턴스를 생성합니다.

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

fromSecondsAheadOfUtc(), asBackendZone(), utc() 및 systemTimeZone()도 참조하십시오 .

[explicit] QTimeZone::QTimeZone(const QByteArray &ianaId)

요청된 IANA ID로 시간대 인스턴스를 생성합니다 ianaId.

ID는 사용 가능한 시스템 ID 중 하나이거나 유효한 UTC-with-offset ID여야 하며, 그렇지 않으면 잘못된 시간대가 반환됩니다. UTC-오프셋이 있는 ID의 경우 실제로 IANA ID가 아닌 경우 결과 인스턴스의 id() 는 생성자에 전달된 ID와 다를 수 있습니다.

이 생성자는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

availableTimeZoneIds() 및 id()도 참조하세요 .

[explicit] QTimeZone::QTimeZone(int offsetSeconds)

UTC에서 지정된 오프셋( offsetSeconds)을 사용하여 시간대 인스턴스를 생성합니다.

UTC에서 offsetSeconds 은 -16시간에서 +16시간 범위여야 하며, 그렇지 않으면 잘못된 시간대가 반환됩니다.

이 생성자는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다. 반환된 인스턴스는 시간대로 구현되었지만 경량 시간 표현인 QTimeZone::fromSecondsAheadOfUtc(offsetSeconds) 과 동일합니다.

MinUtcOffsetSecs, MaxUtcOffsetSecs, id()도 참조하세요 .

QTimeZone::QTimeZone(const QByteArray &zoneId, int offsetSeconds, const QString &name, const QString &abbreviation, QLocale::Territory territory = QLocale::AnyTerritory, const QString &comment = QString())

UTC에서 고정된 오프셋으로 사용자 지정 시간대 인스턴스를 생성합니다.

반환된 표준 시간대는 ID가 zoneId 이고 UTC로부터 오프셋이 offsetSeconds 입니다. name 는 displayName()가 LongName 에 사용하는 이름이고, abbreviation 는 displayName()가 ShortName 및 abbreviation()에 사용하는 이름이며, 선택 사항인 territory 는 territory()가 사용합니다. comment 은 사용자가 시간대를 선택하는 데 도움을 주기 위해 GUI에 표시할 수 있는 선택 사항입니다.

UTC에서 offsetSeconds 는 -16시간에서 +16시간 범위여야 합니다. availableTimeZoneIds ()에 나타나지 않는 UTC 오프셋 이름이 아닌 한 zoneId 는 isTimeZoneIdAvailable()가 참인 ID가 아니어야 합니다.

사용자 지정 시간대에 특정 지역이 없는 경우 기본값인 QLocale::AnyTerritory 으로 설정합니다.

이 생성자는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

id(), offsetFromUtc(), displayName(), abbreviation(), territory(), comment(), MinUtcOffsetSecs, 및 MaxUtcOffsetSecs 을참조하세요 .

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

생성자 복사: other 을 여기로 복사합니다.

[noexcept] QTimeZone::QTimeZone(QTimeZone &&other)

other 에서 이 생성자를 이동합니다.

[noexcept] QTimeZone::~QTimeZone()

표준 시간대를 삭제합니다.

QString QTimeZone::abbreviation(const QDateTime &atDateTime) const

주어진 atDateTime 의 시간대 약어를 반환합니다.

약어는 서머타임 또는 과거 이벤트에 따라 변경될 수 있습니다.

이 방법은 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

displayName()도 참조하세요 .

[since 6.5] QTimeZone QTimeZone::asBackendZone() const

이 QTimeZone 을 timeSpec()이 Qt::TimeZone 인 것으로 변환합니다.

모든 경우에 결과의 timeSpec()는 Qt::TimeZone 입니다. QTimeZone 의 timeSpec()가 Qt::TimeZone 인 경우 QTimeZone 자체가 반환됩니다. timeSpec ()가 Qt::LocalTime 인 경우 systemTimeZone()가 반환됩니다.

timeSpec()가 Qt::UTC 인 경우 QTimeZone::utc()가 반환됩니다. Qt::OffsetFromUTC 인 경우 QTimeZone(int)에 오프셋이 전달되고 결과가 반환됩니다.

현지 시간, UTC 시간 또는 UTC에서 고정된 오프셋의 시간 등 가벼운 시간 표현을 사용하는 경우 timezone 기능이 활성화된 경우에만 지원되는 메서드를 사용하는 것이 해당 시간대를 사용하는 것보다 비용이 더 많이 들 수 있습니다. 이 방법은 경량 시간 표현을 해당 시간대, 즉 시스템 제공 또는 표준 데이터에 기반한 인스턴스에 매핑합니다.

이 방법은 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

이 기능은 Qt 6.5에 도입되었습니다.

QTimeZone(QTimeZone::초기화) 및 fromSecondsAheadOfUtc()도 참조하십시오 .

[static] QList<QByteArray> QTimeZone::availableTimeZoneIds()

이 시스템에서 사용 가능한 모든 IANA 표준 시간대 ID 목록을 반환합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

isTimeZoneIdAvailable()도 참조하세요 .

[static] QList<QByteArray> QTimeZone::availableTimeZoneIds(QLocale::Territory territory)

주어진 territory 에 대해 사용 가능한 모든 IANA 시간대 ID 목록을 반환합니다.

특수한 경우로 AnyTerritory 의 territory 는 UTC 와 같이 영토가 아닌 시간대가 연결된 시간대를 선택하고 World 는 글로벌 기본 IANA ID가 있는 시간대를 선택합니다. 모든 지역에 대한 모든 시간대 ID 목록이 필요한 경우에는 표준 availableTimeZoneIds() 메서드를 사용합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

isTimeZoneIdAvailable() 및 territory()도 참조하세요 .

[static] QList<QByteArray> QTimeZone::availableTimeZoneIds(int offsetSeconds)

주어진 표준 시간 오프셋이 offsetSeconds 인 사용 가능한 모든 IANA 표준 시간대 ID 목록을 반환합니다.

지정된 오프셋이 지원되는 경우, QTimeZone(offsetSeconds).id() 은 IANA ID가 아니더라도 목록에 포함됩니다. 이는 지정된 오프셋을 가진 IANA UTC 오프셋 ID가 없는 경우에만 발생합니다.

이 방법은 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

isTimeZoneIdAvailable() 및 QTimeZone(int)도 참조하세요 .

QString QTimeZone::comment() const

시간대에 대한 모든 댓글을 반환합니다.

사용자가 올바른 시간대를 선택하는 데 도움이 되도록 호스트 플랫폼에서 댓글을 제공할 수 있습니다. 플랫폼에 따라 현지화되지 않을 수 있습니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

int QTimeZone::daylightTimeOffset(const QDateTime &atDateTime) const

주어진 atDateTime 에서 서머타임 오프셋을 반환합니다. 즉, 표준 시간 오프셋에 추가하여 현지 서머타임을 구할 시간(초)을 반환합니다.

예를 들어 시간대 "유럽/베를린"의 경우 DST 오프셋은 +3600초입니다. 표준 시간 동안 daylightTimeOffset()은 0을 반환하고 서머타임이 적용되면 +3600을 반환합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

offsetFromUtc() 및 standardTimeOffset()도 참조하세요 .

QString QTimeZone::displayName(QTimeZone::TimeType timeType, QTimeZone::NameType nameType = QTimeZone::DefaultName, const QLocale &locale = QLocale()) const

현지화된 시간대 표시 이름을 반환합니다.

반환되는 이름은 지정된 timeType 이 유효하고 nameType 으로 표시된 형식일 때 적용되는 지정된 locale 에 대한 이름입니다. 시간대 표시 이름이 시간이 지남에 따라 변경된 경우 현재 이름이 사용됩니다. 주어진 유형의 적절한 현지화된 이름을 사용할 수 없는 경우 다른 이름 유형이 사용되거나 빈 문자열이 반환될 수 있습니다.

locale 을 제공하지 않으면 애플리케이션 기본 로캘이 사용됩니다. 클라이언트 코드에 의해 생성된 사용자 지정 시간대의 경우 현지화 데이터를 사용할 수 없으므로 생성자에 제공된 데이터가 사용됩니다. 이 표준 시간대가 유효하지 않은 경우 빈 문자열이 반환됩니다. 시스템 표준 시간대 결정에 실패한 경우 현지 시간 표현에도 이 문제가 발생할 수 있습니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

abbreviation()도 참조하세요 .

QString QTimeZone::displayName(const QDateTime &atDateTime, QTimeZone::NameType nameType = QTimeZone::DefaultName, const QLocale &locale = QLocale()) const

현지화된 시간대 표시 이름을 반환합니다.

반환되는 이름은 지정된 locale, 지정된 atDateTime 및 nameType 으로 표시된 형식의 이름입니다. 표시 이름은 DST 또는 과거 이벤트에 따라 변경될 수 있습니다. 주어진 유형의 적절한 현지화된 이름을 사용할 수 없는 경우 다른 이름 유형이 사용되거나 빈 문자열이 반환될 수 있습니다.

locale 을 제공하지 않으면 애플리케이션 기본 로캘이 사용됩니다. 클라이언트 코드에 의해 생성된 사용자 지정 시간대의 경우 현지화 데이터를 사용할 수 없으므로 생성자에 제공된 데이터가 사용됩니다. 이 표준 시간대가 유효하지 않은 경우 빈 문자열이 반환됩니다. 시스템 표준 시간대 결정에 실패한 경우 현지 시간 표현에도 이 문제가 발생할 수 있습니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

abbreviation()도 참조하세요 .

[constexpr noexcept, since 6.5] int QTimeZone::fixedSecondsAheadOfUtc() const

timeSpec()가 Qt::OffsetFromUTC 인 경량 시간 표현의 경우 해당 표현이 설명하는 UTC로부터의 고정 오프셋을 반환합니다. 다른 시간 표현의 경우 UTC로부터 일정한 오프셋이 있더라도 0을 반환합니다.

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

[static] QTimeZone QTimeZone::fromCFTimeZone(CFTimeZoneRef timeZone)

CFTimeZone 복사본이 포함된 QTimeZone 을 새로 생성합니다 timeZone.

toCFTimeZone()도 참조하세요 .

[static] QTimeZone QTimeZone::fromNSTimeZone(const NSTimeZone *timeZone)

NSTimeZone의 복사본이 포함된 QTimeZone 을 새로 만듭니다 timeZone.

toNSTimeZone()도 참조하세요 .

[static, since 6.4] QTimeZone QTimeZone::fromStdTimeZonePtr(const int *timeZone)

timeZone 과 같은 시간대를 나타내는 QTimeZone 객체를 반환합니다. timeZone 의 IANA ID는 사용 가능한 시스템 ID 중 하나이어야 하며, 그렇지 않으면 잘못된 시간대가 반환됩니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

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

[since 6.8] bool QTimeZone::hasAlternativeName(QByteArrayView alias) const

alias 이 이 시간대의 대체 이름인 경우 true 을 반환합니다.

IANA(이전의 올슨) 데이터베이스는 그 동안 일부 시간대의 이름을 변경했습니다. 1970년 이전에는 서로 달랐지만 지금은 동의어로 취급되는 일부 시간대도 있습니다. 일부 백엔드에는 1970년 이전까지의 데이터가 있을 수 있으며 후자의 경우 뚜렷한 영역을 생성할 수 있습니다. 다른 백엔드는 id()를 제외하고는 구별할 수 없는 영역을 생성할 수 있습니다. 이 메서드는 ID가 이 시간대 객체가 설명하는 것과 동일한 시간대를 가리키는지(적어도 1970년 이후) 여부를 결정합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

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

bool QTimeZone::hasDaylightTime() const

시간대가 언제든지 서머타임을 시행하는 경우 true 을 반환합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

isDaylightTime() 및 daylightTimeOffset()도 참조하세요 .

bool QTimeZone::hasTransitions() const

시스템 백엔드에서 전환 가져오기를 지원하는 경우 true 을 반환합니다.

전환은 표준 시간대의 변경으로, DST가 켜지거나 꺼질 때 그리고 당국이 표준 시간대의 오프셋을 변경할 때 발생합니다.

이 방법은 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

nextTransition(), previousTransition() 및 transitions()도 참조하세요 .

[static] QByteArray QTimeZone::ianaIdToWindowsId(const QByteArray &ianaId)

주어진 ianaId 에 해당하는 Windows ID를 반환합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

windowsIdToDefaultIanaId() 및 windowsIdToIanaIds()도 참조하세요 .

QByteArray QTimeZone::id() const

표준 시간대의 IANA ID를 반환합니다.

IANA ID는 모든 플랫폼에서 사용됩니다. Windows에서는 Windows ID에서 해당 시간대 및 지역에 가장 잘 일치하는 IANA ID로 변환됩니다.

이 시간대 인스턴스가 IANA ID에서 생성되지 않은 경우, 해당 ID는 생성된 방식에 따라 결정됩니다. 대부분의 경우 인스턴스를 만들 때 전달된 ID가 사용됩니다. (사용자 지정 영역의 생성자는 전달된 ID를 사용하며, 이 ID는 IANA ID가 아니어야 합니다.) 두 가지 예외가 있습니다.

• UTC 오프셋(초)만 전달하여 생성된 인스턴스는 생성할 때 전달된 ID가 없습니다.
• IANA ID만 받는 생성자는 실제로는 IANA ID가 아닌 일부 UTC 오프셋 ID도 허용합니다. 이러한 오프셋을 처리하는 것은 첫 번째 예외와 마찬가지로 해당 오프셋을 초 단위로 전달하는 것과 동일합니다.

두 가지 예외적인 경우, 지정된 오프셋을 가진 IANA UTC 오프셋 영역이 있는 경우 생성된 인스턴스는 생성자에게 전달된 (IANA가 아닌) UTC 오프셋 ID와 다를 수 있지만 해당 IANA 영역의 ID를 사용합니다. 그렇지 않으면 인스턴스는 오프셋에서 합성된 ID를 사용하며, 0초 또는 분의 경우 뒤에 오는 :00을 생략하고 UTC±hh:mm:ss 형식을 사용합니다. 이 경우에도 생성자에 전달된 UTC 오프셋 ID와 다를 수 있습니다.

이 방법은 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

bool QTimeZone::isDaylightTime(const QDateTime &atDateTime) const

지정된 atDateTime 에 서머타임이 적용되면 true 을 반환합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

hasDaylightTime() 및 daylightTimeOffset()도 참조하세요 .

[static] bool QTimeZone::isTimeZoneIdAvailable(const QByteArray &ianaId)

주어진 시간대 ianaId 를 이 시스템에서 사용할 수 있는 경우 true 를 반환합니다.

여기에는 availableTimeZoneIds()에 나열되지 않은 일부 비 IANA ID, 특히 UTC 오프셋 ID가 포함될 수 있습니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

availableTimeZoneIds()도 참조하세요 .

[constexpr noexcept, since 6.5] bool QTimeZone::isUtcOrFixedOffset() const

timeSpec()가 Qt::UTC 또는 Qt::OffsetFromUTC 인 경우 true 를 반환합니다.

참인 경우 현지 시간이나 시간대에 따라 계절에 따라 서머타임이 변경되는 등 시간이 지나도 시간 설명이 변경되지 않습니다. 이를 알면 다른 여러 가지 확인에 필요한 호출 코드를 절약할 수 있습니다.

이 기능은 Qt 6.5에 도입되었습니다.

[static constexpr noexcept, since 6.5] bool QTimeZone::isUtcOrFixedOffset(Qt::TimeSpec spec)

spec 이 Qt::UTC 또는 Qt::OffsetFromUTC 인 경우 true 을 반환합니다.

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

bool QTimeZone::isValid() const

이 시간대가 유효한 경우 true 을 반환합니다.

QTimeZone::OffsetData QTimeZone::nextTransition(const QDateTime &afterDateTime) const

주어진 afterDateTime 이후의 첫 번째 시간대 전환을 반환합니다. 이 함수는 전환 시간이 있고 그 이후의 전환을 찾고자 할 때 가장 유용합니다.

지정된 afterDateTime 이후에 전환이 없는 경우 잘못된 OffsetData 이 반환되고 잘못된 QDateTime 이 atUtc 으로 반환됩니다.

주어진 afterDateTime 은 독점적입니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

hasTransitions(), previousTransition() 및 transitions()도 참조하세요 .

QTimeZone::OffsetData QTimeZone::offsetData(const QDateTime &forDateTime) const

주어진 forDateTime 에서 유효 오프셋 세부 정보를 반환합니다.

이는 abbreviation() 및 세 가지 오프셋 함수를 모두 개별적으로 호출하는 것과 동일하지만 더 효율적이며 약어에 대한 다른 지역화를 얻을 수 있습니다. 지정된 날짜/시간에 이 데이터를 사용할 수 없는 경우 잘못된 OffsetData 이 반환되고 잘못된 QDateTime 이 atUtc 으로 반환됩니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

offsetFromUtc(), standardTimeOffset(), daylightTimeOffset() 및 abbreviation()도 참조하세요 .

int QTimeZone::offsetFromUtc(const QDateTime &atDateTime) const

주어진 atDateTime 에서 총 유효 오프셋을 반환합니다. 즉, 현지 시간을 얻기 위해 UTC에 더해야 하는 시간(초)을 반환합니다. 여기에는 적용될 수 있는 모든 DST 오프셋, 즉 주어진 날짜 시간에 대한 standardTimeOffset()와 daylightTimeOffset()의 합계가 포함됩니다.

예를 들어 표준 시간대 "유럽/베를린"의 경우 표준 시간 오프셋은 +3600초이고 DST 오프셋은 +3600초입니다. 표준 시간 동안 offsetFromUtc()는 +3600(UTC+01:00)을 반환하고, DST 동안에는 +7200(UTC+02:00)을 반환합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

standardTimeOffset() 및 daylightTimeOffset()도 참조하세요 .

QTimeZone::OffsetData QTimeZone::previousTransition(const QDateTime &beforeDateTime) const

주어진 beforeDateTime 이전의 첫 번째 시간대 전환을 반환합니다. 트랜지션 시간이 있고 그 이전의 트랜지션을 찾고자 할 때 가장 유용합니다.

지정된 beforeDateTime 이전에 전환이 없는 경우 잘못된 OffsetData 이 반환되고 잘못된 QDateTime 이 atUtc 으로 반환됩니다.

주어진 beforeDateTime 은 독점적입니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

hasTransitions(), nextTransition() 및 transitions()도 참조하세요 .

int QTimeZone::standardTimeOffset(const QDateTime &atDateTime) const

주어진 atDateTime 에서 표준 시간 오프셋을 반환합니다. 즉, 현지 표준 시간을 얻기 위해 UTC에 더해야 하는 시간(초)입니다. 여기에는 적용될 수 있는 DST 오프셋이 제외됩니다.

예를 들어 표준 시간대 '유럽/베를린'의 경우 표준 시간 오프셋은 +3600초입니다. 표준 및 DST 모두에서 offsetFromUtc()는 +3600(UTC+01:00)을 반환합니다.

이 방법은 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

offsetFromUtc() 및 daylightTimeOffset()도 참조하세요 .

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

이 시간대 인스턴스를 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

[static] QTimeZone QTimeZone::systemTimeZone()

현지 시스템 시간을 설명하는 QTimeZone 객체를 반환합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다. 반환된 인스턴스는 일반적으로 시간대로 구현되기는 하지만 경량 시간 표현인 QTimeZone(QTimeZone::LocalTime) 과 동일합니다.

반환된 객체는 이후 시스템 시간대의 변경을 반영하도록 변경되지 않습니다. asBackendZone ()가 호출되었을 때 적용되던 현지 시간을 나타냅니다. Qt가 컴파일된 백엔드에서 의존하는 시간대 데이터가 없는 시스템과 같이 잘못 구성된 시스템에서는 유효하지 않을 수 있습니다. 이 경우 경고가 출력됩니다.

utc(), Initialization, asBackendZone() 및 systemTimeZoneId()도 참조하세요 .

[static] QByteArray QTimeZone::systemTimeZoneId()

현재 시스템 표준 시간대 IANA ID를 반환합니다.

systemTimeZone()를 호출하는 것과 동일합니다.id(), 그러나 일부 계산을 우회하여 얻을 수 있습니다. 반환된 바이트 배열에서 QTimeZone 을 구성하면 systemTimeZone()과 동일한 결과가 생성됩니다.

백엔드에서 올바른 시스템 영역을 확인할 수 없는 경우 결과는 비어 있습니다. 이 경우 systemTimeZone().isValid()는 거짓이며 systemTimeZone()의 이 메서드가 호출되면 경고가 출력됩니다.

백엔드에서 올바른 시스템 영역을 확인할 수 있지만 이름을 확인할 수 없는 경우 빈 바이트 배열이 반환됩니다. 예를 들어 Windows에서는 시스템 기본 ID가 IANA ID로 변환되며, 시스템 ID를 내부 번역 코드에서 알 수 없는 경우 결과가 비어 있습니다. 이 경우 systemTimeZone().isValid()는 참이어야 합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

systemTimeZone()도 참조하세요 .

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

표준 시간대의 영토를 반환합니다.

AnyTerritory 반환은 해당 시간대에 알려진 영토 연결이 없음을 의미합니다. 일부 경우에는 영역에 연결된 표준 시간대(예: UTC)가 없거나 영역이 여러 표준 시간대(예: CET)에서 사용되기 때문일 수 있습니다. 다른 경우에는 QTimeZone 백엔드가 해당 영역이 사용되는 지역의 기본 영역이 아니기 때문에 해당 영역이 연결된 지역을 알지 못할 수도 있습니다(예: 해당 영역이 사용되는 지역의 기본 영역이 아니기 때문).

이 방법은 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

이 기능은 Qt 6.2에 도입되었습니다.

[constexpr noexcept, since 6.5] Qt::TimeSpec QTimeZone::timeSpec() const

시간 표현 유형을 식별하는 Qt::TimeSpec 을 반환합니다.

결과가 Qt::TimeZone 인 경우 이 시간 설명은 시간대(시스템 제공 또는 표준 데이터로 뒷받침됨)이며, 그렇지 않으면 가벼운 시간 표현입니다. 결과가 Qt::LocalTime 인 경우 현지 시간을 나타냅니다. 자세한 내용은 Qt::TimeSpec 을 참조하세요.

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

fixedSecondsAheadOfUtc() 및 asBackendZone()도 참조하세요 .

CFTimeZoneRef QTimeZone::toCFTimeZone() const

QTimeZone 에서 CFTimeZone을 생성합니다.

호출자는 CFTimeZone 객체를 소유하고 이를 해제할 책임이 있습니다.

fromCFTimeZone()도 참조하세요 .

NSTimeZone *QTimeZone::toNSTimeZone() const

QTimeZone 에서 NSTimeZone을 생성합니다.

NSTimeZone 오브젝트는 자동 릴리스됩니다.

fromNSTimeZone()도 참조하세요 .

QTimeZone::OffsetDataList QTimeZone::transitions(const QDateTime &fromDateTime, const QDateTime &toDateTime) const

주어진 날짜 시간 사이의 모든 시간대 전환 목록을 반환합니다.

주어진 fromDateTime 및 toDateTime 이 포함됩니다. 각 항목의 atUtc 멤버는 다른 멤버가 지정한 오프셋과 약어가 적용되는 전환 시점을 설명합니다.

이 방법은 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

hasTransitions(), nextTransition() 및 previousTransition()도 참조하세요 .

[static] QTimeZone QTimeZone::utc()

UTC를 표준 시간대로 설명하는 QTimeZone 객체를 반환합니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다. 이는 QTimeZone(int offsetSeconds) 및 경량 시간 표현 QTimeZone(QTimeZone::UTC)에 0을 전달하는 것과 동일하지만, 후자와는 달리 시간대로 구현됩니다.

systemTimeZone(), Initialization, asBackendZone()도 참조하세요 .

[static] QByteArray QTimeZone::windowsIdToDefaultIanaId(const QByteArray &windowsId)

주어진 windowsId 에 대한 기본 IANA ID를 반환합니다.

Windows ID가 여러 다른 영역의 여러 IANA ID를 포함할 수 있으므로 이 함수는 영역에 관계없이 가장 자주 사용되는 IANA ID를 반환하므로 주의해서 사용해야 합니다. 일반적으로 특정 지역에 대한 기본값을 요청하는 것이 가장 좋습니다.

이 방법은 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

ianaIdToWindowsId() 및 windowsIdToIanaIds()도 참조하세요 .

[static] QByteArray QTimeZone::windowsIdToDefaultIanaId(const QByteArray &windowsId, QLocale::Territory territory)

주어진 windowsId 및 territory 에 대한 기본 IANA ID를 반환합니다.

Windows ID는 주어진 영역 내에서 여러 IANA ID를 포함할 수 있으므로 해당 영역에서 가장 자주 사용되는 IANA ID가 반환됩니다.

특수한 경우로 AnyTerritory 는 영역 외의 연관성이 있는 IANA ID의 기본값을 반환하고 World 는 특정 연관성이 없는 영역에서 주어진 windowsId 에 대한 기본값을 반환합니다.

반환값이 비어 있으면 이 windowsId 에 대해 지정된 territory 에 해당하는 IANA ID가 없는 것입니다. 이 경우 windowsIdToDefaultIanaId(windowsId) 로 되돌아가는 것이 합리적입니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

ianaIdToWindowsId(), windowsIdToIanaIds() 및 territory()도 참조하세요 .

[static] QList<QByteArray> QTimeZone::windowsIdToIanaIds(const QByteArray &windowsId)

주어진 windowsId 에 대한 모든 IANA ID를 반환합니다.

반환된 목록은 알파벳순으로 정렬됩니다.

이 메서드는 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

ianaIdToWindowsId() 및 windowsIdToDefaultIanaId()도 참조하세요 .

[static] QList<QByteArray> QTimeZone::windowsIdToIanaIds(const QByteArray &windowsId, QLocale::Territory territory)

주어진 windowsId 및 territory 에 대한 모든 IANA ID를 반환합니다.

특수한 경우로 AnyTerritory 는 영역 외의 연관성이 있는 IANA ID를 선택하고 World 는 특정 연관성이 없는 영역에서 주어진 windowsId 에 대한 기본값을 선택합니다.

반환되는 목록은 사용 빈도가 높은 순서대로 나열되며, 즉 한 영역 내에서 더 큰 영역이 먼저 나열됩니다.

이 방법은 timezone 기능이 활성화된 경우에만 사용할 수 있습니다.

ianaIdToWindowsId(), windowsIdToDefaultIanaId() 및 territory()도 참조하세요 .

[noexcept] QTimeZone &QTimeZone::operator=(QTimeZone &&other)

이동 - other 을 이 QTimeZone 인스턴스에 할당하여 해당 데이터의 소유권을 이 인스턴스로 이전합니다.

QTimeZone &QTimeZone::operator=(const QTimeZone &other)

할당 연산자, other 여기에 할당합니다.