fn:timezone-from-dateTime 関数

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

構文

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

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

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

戻り値

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

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

例

次の関数は、 UTC-8 時間帯の 2009 年 10 月 30 日午前 7:30 の dateTime 値の時間帯コンポーネントを 戻します。

fn:timezone-from-dateTime(xs:dateTime("2009-10-30T07:30:00-08:00"))

戻り値は -PT8H です。

次の関数は、UTC+10:30 時間帯の 2009 年 1 月 1 日午後 2:30 の dateTime 値の時間帯コンポーネントを 戻します。

fn:timezone-from-dateTime(xs:dateTime("2009-01-01T14:30:00+10:30"))

戻り値は PT10H30M です。