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 タイプです。次の表は、 戻り値の取りうる値を説明しています。
| 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 です。
