fn:timezone-from-time 関数

fn:timezone-from-time 関数は、 xs:time 値の時間帯コンポーネントを 戻します。

構文

構文図を読む
>>-fn:timezone-from-time(time-value)---------------------------><

time-value
時間帯コンポーネントの抽出元の時刻値。

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

戻り値

time-value が xs:time タイプであり、明示的な時間帯コンポーネントが付いている場合、 戻り値は xs:dayTimeDuration タイプで、-PT14H から PT14H (両端を含む) の範囲内の 値です。値は、time-value 時間帯コンポーネント の UTC 時間帯からの 偏差です。

time-value に明示的な時間帯コンポーネントが付いていないか、これが空シーケンスである場合、戻り値は空シーケンスです。

例

次の関数は、 UTC-5 時間帯の正午 12 時の時刻値の 時間帯コンポーネントを 戻します。

fn:timezone-from-time(xs:time("12:00:00-05:00"))

戻り値は -PT5H です。

次の関数で、午後 1:00 の時刻値には 時間帯コンポーネントが付いていません。

fn:timezone-from-time(xs:time("13:00:00"))

戻り値は 空シーケンスです。