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