QTimeZone Class

メンバ関数のドキュメント

[noexcept] QTimeZone::QTimeZone()

nullまたは無効なタイムゾーンインスタンスを作成します。

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

UTCまたは現地時間を表す軽量なインスタンスを作成します。

この関数は Qt 6.5 で導入されました。

fromSecondsAheadOfUtc()、asBackendZone()、utc()、およびsystemTimeZone()も参照してください 。

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

指定された IANA IDianaId を持つタイムゾーンインスタンスを作成します。

ID は、利用可能なシステム ID または有効なオフセット付き UTC ID のいずれかでなければなりません。そうでない場合、無効なタイムゾーンが返されます。オフセット付き UTC ID の場合、それが実際には IANA ID ではないときは、結果として得られるインスタンスのid() が、コンストラクタに渡された ID と異なることがあります。

このコンストラクタは、timezone 機能が有効になっている場合にのみ利用可能です。

availableTimeZoneIds() およびid()も参照してください 。

[explicit] QTimeZone::QTimeZone(int offsetSeconds)

指定されたオフセット（offsetSeconds ）を基に、UTCからのタイムゾーンインスタンスを作成します。

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時間の範囲内である必要があります。zoneId は、availableTimeZoneIds()に表示されないUTCオフセット名でない限り、isTimeZoneIdAvailable()が真となるIDであってはなりません。

カスタムタイムゾーンに特定の地域が設定されていない場合は、デフォルト値であるQLocale::AnyTerritory に設定してください。

このコンストラクタは、timezone 機能が有効になっている場合にのみ利用可能です。

関連項目： id()、offsetFromUtc()、displayName()、abbreviation()、territory()、comment()、MinUtcOffsetSecs 、およびMaxUtcOffsetSecs 。

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

コピーコンストラクタ：other を this にコピーする。

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

other から、このクラスの移動コンストラクタを移動しました。

[noexcept] QTimeZone::~QTimeZone()

タイムゾーンを削除します。

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

指定されたatDateTime のタイムゾーンの略称を返します。

この略称は、夏時間（DST）や歴史的な出来事によって変更される場合があります。

このメソッドは、機能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::Initialization) およびfromSecondsAheadOfUtc()も参照してください 。

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

このシステムで使用可能なタイムゾーン ID のリストを返します。

これには、システムのタイムゾーン情報ソースでサポートされている各ゾーンの IANA ID に加え、それらのエイリアスや、一般的に使用される UTC オフセット ID の限定されたセットが含まれます。

QTimeZone コンストラクタは、返されるリストに含まれていない一部のUTCオフセットIDも受け付けます。これは、考えられるすべてのUTCオフセットIDをリストアップすることは現実的ではないためです。また、サポートされているIANA IDの既知の別名も受け付けますが、その一部はこのリストに表示されない場合があります。このようなIDは、isTimeZoneIdAvailable() でも受け付けられます。

Unicodeコンソーシアムの共通ロケールデータリポジトリ（CLDR）が、サポートされているIANA IDをそのゾーンの安定名の別名と見なしている場合、 そのゾーンの安定名称も（たとえ情報が古くなっている場合でも）、安定性を確保するため、および異なるシステムタイムゾーン情報ソースが同一のゾーンに対して異なるエイリアスを使用する場合のクロスプラットフォーム上の共通基盤として、このリストに含まれます。

このメソッドは、機能timezone が有効になっている場合にのみ利用可能です。

isTimeZoneIdAvailable() およびhasAlternativeName()も参照してください 。

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

指定されたterritory に対して利用可能なすべてのIANAタイムゾーンIDのリストを返します。

特例として、territory にAnyTerritory を指定すると、UTCなどの特定の地域に紐づかないタイムゾーンが選択され、World を指定すると、グローバルなデフォルトのIANA IDを持つタイムゾーンが選択されます。すべての地域に対するすべてのタイムゾーンIDのリストが必要な場合は、標準のavailableTimeZoneIds()メソッドを使用してください。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

isTimeZoneIdAvailable() およびterritory()も参照してください 。

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

指定された標準時刻オフセット「offsetSeconds 」を持つ、利用可能なすべてのIANAタイムゾーンIDのリストを返します。

指定されたオフセットがサポートされている場合、たとえそれが IANA ID でなかったとしても、QTimeZone(offsetSeconds).id() がリストに含まれます。これは、指定されたオフセットを持つ IANA UTC オフセット ID が存在しない場合にのみ発生します。

このメソッドは、機能timezone が有効になっている場合にのみ利用可能です。

isTimeZoneIdAvailable() およびQTimeZone(int)も参照してください 。

QString QTimeZone::comment() const

そのタイムゾーンに関するコメントを返します。

コメントは、ユーザーが正しいタイムゾーンを選択できるよう、ホストプラットフォームによって提供される場合があります。プラットフォームによっては、ローカライズされていない場合があります。

このメソッドは、機能「timezone 」が有効になっている場合にのみ利用可能です。

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

指定されたatDateTime における夏時間のオフセット、すなわち、標準時間のオフセットに足して現地の夏時間を算出するための秒数を返します。

たとえば、タイムゾーン「Europe/Berlin」の場合、夏時間のオフセットは+3600秒です。標準時間の期間中、daylightTimeOffset()は0を返し、夏時間が適用されている期間中は+3600を返します。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

offsetFromUtc() およびstandardTimeOffset()も参照してください 。

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

ローカライズされたタイムゾーンの表示名を返します。

返される名称は、指定されたlocale に対応するものであり、指定されたtimeType が有効な場合に適用され、nameType で示される形式となります。タイムゾーンの表示名が時間の経過とともに変更された場合、現在の名称が使用されます。指定されたタイプの適切にローカライズされた名称が利用できない場合、別の名称タイプが使用されるか、空の文字列が返されることがあります。

locale が指定されていない場合は、アプリケーションのデフォルトのロケールが使用されます。 クライアントコードによって作成されたカスタムタイムゾーンについては、ローカライズデータが利用できないため、コンストラクタに指定されたデータが使用されます。このタイムゾーンが無効な場合は、空の文字列が返されます。これは、システムタイムゾーンの判定に失敗した場合の現地時間の表現においても発生する可能性があります。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

abbreviation()も参照してください 。

QString QTimeZone::displayName(const QDateTime &atDateTime, QTimeZone::NameType nameType = 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)

CFTimeZonetimeZone のコピーを含む新しい `QTimeZone ` を生成します。

toCFTimeZone()も参照してください 。

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も参照してください 。

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

NSTimeZonetimeZone のコピーを含む新しいQTimeZone を生成します。

toNSTimeZone()も参照してください 。

[static, since 6.4] QTimeZone QTimeZone::fromStdTimeZonePtr(const std::chrono::time_zone *timeZone)

timeZone と同じタイムゾーンを表す `QTimeZone ` オブジェクトを返します。timeZone の IANA ID は、利用可能なシステム ID のいずれかでなければなりません。そうでない場合、無効なタイムゾーンが返されます。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

この関数は Qt 6.4 で導入されました。

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

alias がこのタイムゾーンの別名である場合、true を返します。

IANA（旧Olson）データベースでは、その歴史の中で一部のタイムゾーンの名称が変更されています。また、1970年以前は名称が異なっていたものの、現在は同義として扱われているタイムゾーンもいくつかあります。 一部のバックエンドでは、1970年以前のデータが残っている場合があり、後者のケースでは異なるタイムゾーンとして扱われることがあります。また、id() によってのみ区別できるタイムゾーンとして扱われる場合もあります。このメソッドは、ある ID が（少なくとも1970年以降において）このタイムゾーンオブジェクトが記述するタイムゾーンと同じものを指しているかどうかを判定します。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

この関数は Qt 6.8 で導入されました。

isTimeZoneIdAvailable()も参照してください 。

bool QTimeZone::hasDaylightTime() const

そのタイムゾーンで過去に夏時間が実施されたことがある場合、true を返します。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

isDaylightTime() およびdaylightTimeOffset()も参照してください 。

bool QTimeZone::hasTransitions() const

システムのバックエンドがトランジションの取得に対応している場合、true を返します。

トランジションとは、タイムゾーンにおける変更のことです。これらは、夏時間が開始または終了したとき、あるいは当局がタイムゾーンのオフセットを変更したときに発生します。

このメソッドは、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を使用しますが、これはIANA IDであってはなりません。）ただし、2つの例外があります。

• 秒単位のUTCオフセットのみを渡して構築されたインスタンスには、構築時にIDが渡されません。
• IANA IDのみを受け取るコンストラクタは、実際にはIANA IDではない一部のUTCオフセットIDも受け入れます。これらに対する処理は、最初の例外と同様に、対応するオフセットを秒単位で渡すことと同等です。

これら2つの例外の場合、指定されたオフセットを持つIANA UTCオフセットゾーンが存在すれば、コンストラクタに渡された（非IANAの）UTCオフセットIDとは異なる場合であっても、生成されたインスタンスはそのIANAゾーンのIDを使用します。 そうでない場合、インスタンスはそのオフセットから合成された ID を使用します。形式は UTC±hh:mm:ss で、秒または分が 0 の場合は末尾の :00 は省略されます。これもまた、コンストラクタに渡された UTC オフセット ID とは異なる場合があります。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

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

指定されたatDateTime の時点で夏時間が適用されていた場合、true を返します。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

hasDaylightTime() およびdaylightTimeOffset()も参照してください 。

[static] bool QTimeZone::isTimeZoneIdAvailable(QByteArrayView ianaId)

指定されたタイムゾーンianaId がこのシステム上で利用可能な場合、true を返します。

これは、実際には IANA ID ではない一部のテキスト、特に UTC オフセット ID や、availableTimeZoneIds() にリストされていないサポートされている IANA ID の既知の別名について当てはまる場合があります。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

availableTimeZoneIds() およびhasAlternativeName()も参照してください 。

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

timeSpec() の結果がQt::UTC またはQt::OffsetFromUTC の場合、true を返します。

これが 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 が返され、そのatUtc として無効なQDateTime が設定されます。

指定されたafterDateTime は排他的です。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

hasTransitions()、previousTransition()、およびtransitions()も参照してください 。

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

指定されたforDateTime における有効なオフセットの詳細を返します。

これは、abbreviation() を呼び出すことや、3つのオフセット関数を個別に呼び出すことと同等ですが、より効率的である可能性があり、略語のローカライズ結果が異なる場合があります。指定された日時に対してこのデータが利用できない場合、無効なOffsetData が返され、そのatUtc として無効なQDateTime が設定されます。

このメソッドは、機能timezone が有効になっている場合にのみ利用可能です。

offsetFromUtc()、standardTimeOffset()、daylightTimeOffset()、およびabbreviation()も参照してください 。

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

指定されたatDateTime における有効なオフセットの合計、すなわち、現地時間を算出するためにUTCに加算すべき秒数を返します。これには、適用されている可能性のある夏時間（DST）のオフセットも含まれます。つまり、指定された日時におけるstandardTimeOffset()とdaylightTimeOffset()の合計値となります。

たとえば、タイムゾーン「Europe/Berlin」の場合、標準時のオフセットは +3600 秒、夏時間のオフセットも +3600 秒です。 標準時間中は、offsetFromUtc() は +3600 (UTC+01:00) を返し、夏時間中は +7200 (UTC+02:00) を返します。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

standardTimeOffset() およびdaylightTimeOffset()も参照してください 。

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

指定された「beforeDateTime 」の直前のタイムゾーン遷移を返します。これは、遷移時刻がわかっており、その直前の遷移を探したい場合に特に役立ちます。

指定されたbeforeDateTime より前のトランジションが存在しない場合、無効なOffsetData が返され、そのatUtc には無効なQDateTime が設定されます。

指定されたbeforeDateTime は排他的です。

このメソッドは、timezone 機能が有効になっている場合にのみ利用可能です。

hasTransitions()、nextTransition()、およびtransitions()も参照してください 。

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

指定されたatDateTime における標準時間オフセット、すなわちUTCに加算して現地の標準時間を算出するための秒数を返します。これには、適用されている可能性のある夏時間（DST）のオフセットは含まれません。

たとえば、タイムゾーン「Europe/Berlin」の場合、標準時刻オフセットは+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 XML がコンパイルされたバックエンドが依存するタイムゾーンデータが欠落しているなど、設定が不適切なシステムでは、このオブジェクトが無効になる可能性があります。そのような場合、警告が出力されます。

utc()、Initialization 、asBackendZone()、およびsystemTimeZoneId()も参照してください 。

[static] QByteArray QTimeZone::systemTimeZoneId()

現在のシステムのタイムゾーンの IANA ID を返します。

systemTimeZone() やid() を呼び出すのと同じですが、それを取得するための計算の一部を省略する場合があります。返されたバイト配列からQTimeZone を構築すると、systemTimeZone() と同じ結果が得られます。

バックエンドが正しいシステムゾーンを特定できない場合、結果は空になります。この場合、systemTimeZone() およびisValid() は false となり、systemTimeZone() のいずれかのメソッドが呼び出されると警告が出力されます。

バックエンドが正しいシステムゾーンを特定できるが、その名前を特定できない場合、空のバイト配列が返されます。たとえば、Windows では、システムのネイティブ ID が IANA ID に変換されますが、内部の変換コードがシステム ID を認識していない場合、結果は空となります。 この場合、systemTimeZone() およびisValid() は true になります。

このメソッドは、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 ` を代入します。