fn:adjust-date-to-timezone 関数

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

構文

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

date-value
調整される日付値。

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

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

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

戻り値

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

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

date-value を 別の時間帯に調整する場合、 date-value は、時間コンポーネント 00:00:00 が付いた dateTime 値として扱われます。戻り値には、timezone-value で表される時間帯コンポーネントが含まれます。 以下の関数は、調整された日付値を計算します。

xs:date(fn:adjust-dateTime-to-timezone(xs:dateTime(date-value),timezone-value))

例

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

以下の関数は、 UTC+1 時間帯の 2009 年 5 月 7 日の日付値を 調整します。関数は、-PT10H の timezone-value を 指定します。

fn:adjust-date-to-timezone(xs:date("2009-05-07+01:00"), $tz) 

戻される 日付値は、2009-05-06-10:00 です。日付は UTC-10 時間帯に調整されます。

以下の関数は、時間帯コンポーネントがない 2009 年 3 月 7 日の日付値に時間帯コンポーネントを追加します。 関数は、-PT10H の timezone-value を指定します。

fn:adjust-date-to-timezone(xs:date("2009-03-07"), $tz)

戻り値は 2009-03-07-10:00 です。時間帯コンポーネントが、 日付値に追加されます。

以下の関数は、UTC-7 時間帯の 2009 年 2 月 9 日の 日付値を調整します。timezone-value が指定されない場合、 関数は、timezone-value のデフォルト値 PT0H を使用します。

fn:adjust-date-to-timezone(xs:date("2009-02-09-07:00"))

戻される日付は、 2009-02-09Z です。日付は UTC に調整されます。

以下の関数は、 UTC-7 時間帯の 2009 年 3 月 7 日 の日付値から 時間帯コンポーネントを除去します。timezone-value は、 空シーケンスです。

fn:adjust-date-to-timezone(xs:date("2009-05-07-07:00"), ())

戻り値は 2009-05-07 です。