fn:adjust-time-to-timezone 関数

fn:adjust-time-to-timezone 関数は、 xs:time 値を特定の時間帯に調整するか、xs:time 値から時間帯コンポーネントを 除去します。

構文

構文図を読む
>>-fn:adjust-time-to-timezone(time-value-+-----------------+-)-><
                                         '-,timezone-value-'     

time-value
調整される時刻値。

time-value は、タイプ xs:time か、 または空のシーケンスです。

timezone-value
time-value の調整対象の 時間帯を示す 期間。

timezone-value は、空シーケンスにするか、 -PT14H から PT14H (両端を含む) の範囲内の xs:dayTimeDuration タイプの単一値にすることが できます。値には分数 (整数) を指定できますが、秒のコンポーネントで指定しては なりません。timezone-value が指定されない場合、 デフォルト値は PT0H です。これは UTC を表します。

戻り値

戻り値は、 指定されたパラメーターに応じて、 xs:time タイプの値か空シーケンスのいずれか です。time-value が空シーケンスでない場合、 戻り値は xs:time タイプです。次の表は、 戻り値の取りうる値を説明しています。

表 1. fn:adjust-time-to-timezone の入力値および戻り値の タイプ
date-value timezone-value 戻り値
時間帯コンポーネントを含む time-value 明示値が指定されているか、または値が指定されていません (PT0H の期間) timezone-value で表される 時間帯に調整された time-value。戻り値には、timezone-value で表される時間帯コンポーネントが含まれます。 時間帯調整が午前零時を超えた場合、日付の変更は 無視されます。
時間帯コンポーネントを含む time-value 空シーケンス 時間帯コンポーネントを含まない time-value。
時間帯コンポーネントを含まない time-value 明示値が指定されているか、または値が指定されていません (PT0H の期間)

時間帯コンポーネントを 含む time-value。時間帯コンポーネントは、timezone-value で表される時間帯です。 時間コンポーネントは、時間帯に 調整されません。

時間帯コンポーネントを含まない time-value 空シーケンス time-value。
空シーケンス 明示的な値、空シーケンス、または指定された値 なし 空シーケンス。

例

以下の例で、変数 $tz は、-10 時間の期間であり、xs:dayTimeDuration("-PT10H") として定義されます。

以下の関数は、 UTC-7 時間帯の午前 10:00 の時刻値を調整し、 -PT10H の timezone-value を 指定します。

fn:adjust-time-to-timezone(xs:time("10:00:00-07:00"), $tz) 

戻り値は 7:00:00-10:00 です。時間は、-PT10H の期間で表される時間帯に 調整されます。

以下の関数は、 午後 1:00 の時刻値を調整します。この時刻値には、 時間帯コンポーネントは含まれません。

fn:adjust-time-to-timezone(xs:time("13:00:00"), $tz)

戻り値は 13:00:00-10:00 です。時間には、-PT10H の期間で表される時間帯コンポーネントが 含まれます。

以下の関数は、UTC-7 時間帯の 午前 10:00 の時刻値を調整します。関数では、 timezone-value を指定せず、デフォルト値の PT0H を使用します。

fn:adjust-time-to-timezone(xs:time("10:00:00-07:00"))

戻り値は、 UTC に調整された時間、17:00:00Z です。

以下の関数は、 UTC-7 時間帯の午前 8:00 の時刻値から時間帯コンポーネントを 除去します。timezone-value は、 空シーケンスです。

fn:adjust-time-to-timezone(xs:time("08:00:00-07:00"), ())

戻り値は 8:00:00 です。

以下の例は、2 つの時刻を 比較しています。時間帯調整が午前零時を超えたため、通常は日付変更が発生します。しかし、fn:adjust-time-to-timezone は日付変更を 無視します。

fn:adjust-time-to-timezone(xs:time("01:00:00+14:00"), $tz) 
   = xs:time("01:00:00-10:00")

戻り値は true です。