fonction timezone-from-time
La fonction fn:timezone-from-time renvoie le composant de fuseau horaire d'une valeur xs: time.
Syntaxe
- time-value
- Valeur temporelle à partir de laquelle le composant de fuseau horaire doit être extrait.
time-value est de type xs:time ou est une séquence vide.
Valeur renvoyée
Si la valeur temporelle est de type xs:time et a une composante explicite de fuseau horaire, la valeur retournée est de type xdt:dayTimeDuration, et la valeur est comprise entre -PT14H et PT14H, inclusivement. La valeur est l'écart du composant de fuseau horaire time-value par rapport au fuseau horaire UTC.
Si time-value n'a pas de composant de fuseau horaire explicite ou qu'il s'agit d'une séquence vide, la valeur renvoyée est une séquence vide.
Exemples
La fonction suivante renvoie le composant de fuseau horaire de la valeur horaire pour midi dans le fuseau horaire UTC-5 .
fn:timezone-from-time(xs:time("12:00:00-05:00"))La valeur renvoyée est -PT5H.
Dans la fonction suivante, la valeur d'heure de 13h00 ne comporte pas de composant de fuseau horaire.
fn:timezone-from-time(xs:time("13:00:00"))La valeur renvoyée est la séquence vide.