Fonctions XPath/XQuery : Date et heure
Les fonctions d'extension date/heure d'Altova peuvent être utilisées dans les expressions XPath et XQuery et fournissent des fonctions supplémentaires pour le traitement des données contenues en tant que les types de données de date et d'heures variés de XML Schema.
Note concernant le nommage de fonctions et de l'applicabilité de la langue
Les fonctions d'extension Altova peuvent être utilisées dans les expressions XPath/XQuery. Elles fournissent des fonctions supplémentaires aux fonctions d'ores et déjà disponibles dans la librairie standard des fonctions XPath, XQuery et XSLT. •Afin de distinguer les fonctions d'extension Altova des fonctions dans la librairie standard, les fonctions d'extension Altova sont nommées dans cette documentation avec un suffixe [altova:]. Par exemple : add-years-to-date [altova:]. •Néanmoins, lorsque vous utilisez des fonctions d'extension Altova dans vos expressions XPath/XQuery, vous devez utiliser la fonction sans préfixe ou suffixe, comme si vous utilisiez une fonction standard XPath/XQuery. Voici un exemple d'extension Altova : add-years-to-date(xs:date("2014-01-15"), 10).
|
altova:add-minutes-to-dateTime altova:add-seconds-to-dateTime altova:dateTime-from-epoch-no-TZ altova:hours-from-dateTimeDuration-accumulated altova:minutes-from-dateTimeDuration-accumulated |
[ Haut ]
Ajouter une durée à xs:dateTime XP3.1 XQ3.1
Ces fonctions ajoutent une durée à xs:dateTime et retournent xs:dateTime. Le type xs:dateTime a un format de CCYY-MM-DDThh:mm:ss.sss. Il s'agit d'une concaténation des formats xs:date et xs:time séparés par la lettre T. Un suffixe de fuseau horaire (+01:00, par exemple) est optionnel.
add-years-to-dateTime(DateTime as xs:dateTime, Years as xs:integer) asxs:dateTime XP3.1 XQ3.1 Ajoute une durée en années à xs:dateTime (voir exemples ci-dessous). Le deuxième argument est le nombre d'années à être ajouté à xs:dateTime fourni en tant que le premier argument. Le résultat est de type xs:dateTime.
|
add-months-to-dateTime(DateTime as xs:dateTime, Months as xs:integer) asxs:dateTime XP3.1 XQ3.1 Ajoute une durée en mois à xs:dateTime (voir exemples ci-dessous). Le deuxième argument est le nombre de mois à être ajouté à xs:dateTime fourni en tant que le premier argument. Le résultat est de type xs:dateTime.
|
add-days-to-dateTime(DateTime as xs:dateTime, Days as xs:integer) asxs:dateTime XP3.1 XQ3.1 Ajoute une durée en jours à xs:dateTime (voir exemples ci-dessous). Le deuxième argument est le nombre de jours à être ajouté à xs:dateTime fourni en tant que le premier argument. Le résultat est de type xs:dateTime.
|
add-hours-to-dateTime(DateTime as xs:dateTime, Hours as xs:integer) asxs:dateTime XP3.1 XQ3.1 Ajoute une durée en heures à xs:dateTime (voir exemples ci-dessous). Le deuxième argument est le nombre d'heures à être ajouté à xs:dateTime fourni en tant que le premier argument. Le résultat est de type xs:dateTime.
|
add-minutes-to-dateTime(DateTime as xs:dateTime, Minutes as xs:integer) asxs:dateTime XP3.1 XQ3.1 Ajoute une durée en minutes à xs:dateTime (voir exemples ci-dessous). Le deuxième argument est le nombre of minutes à être ajouté à xs:dateTime fourni en tant que le premier argument. Le résultat est de type xs:dateTime.
|
add-seconds-to-dateTime(DateTime as xs:dateTime, Seconds as xs:integer) asxs:dateTime XP3.1 XQ3.1 Ajoute une durée en secondes à xs:dateTime (voir exemples ci-dessous). Le deuxième argument est le nombre de secondes à être ajouté à xs:dateTime fourni en tant que le premier argument. Le résultat est de type xs:dateTime.
|
[ Haut ]
Ajouter une durée à xs: date XP3.1 XQ3.1
Ces fonctions ajoutent une durée à xs: date et retournent xs: date. Le type xs:date a un format CCYY-MM-DD.
add-years-to-date(Date as xs:date, Years as xs:integer) asxs:date XP3.1 XQ3.1 Ajoute une durée en années à une date. Le deuxième argument est le nombre d'années à être ajouté à xs:date fourni en tant que le premier argument. Le résultat est de type xs:date.
|
add-months-to-date(Date as xs:date, Months as xs:integer) asxs:date XP3.1 XQ3.1 Ajoute une durée en mois à une date. Le deuxième argument est le nombre de mois à être ajouté à xs:date fourni en tant que le premier argument. Le résultat est de type xs:date.
|
add-days-to-date(Date as xs:date, Days as xs:integer) asxs:date XP3.1 XQ3.1 Ajoute une durée en jours à une date. Le deuxième argument est le nombre de jours à être ajouté à xs:date fourni en tant que le premier argument. Le résultat est de type xs:date.
|
[ Haut ]
Formater et récupérer des durées XP3.1 XQ3.1
Ces fonctions parsent une entrée xs:duration ou xs:string et retournent respectivement un xs:string ou xs:duration.
format-duration(Duration as xs:duration, Picture as xs:string) asxs:string XP3.1 XQ3.1 Formate une durée qui est soumise en tant que le premier argument, selon une chaîne d'image soumise en tant que le second argument. La sortie est une chaîne de texte formatée conformément à la chaîne d'image.
|
parse-duration(InputString as xs:string, Picture as xs:string) as xs:duration XP3.1 XQ3.1 Takes a patterned string as the first argument, and a picture string as the second argument. The input string is parsed on the basis of the picture string, and an xs:duration is returned.
|
[ Haut ]
Ajouter une durée à xs:time XP3.1 XQ3.1
Ces fonctions ajoutent une durée à xs:time et retournent xs:time. Le type xs:time a une forme lexicale de hh:mm:ss.sss. Un fuseau horaire en option peut être suffixé. La lettre Z indique le Temps universel coordonné (UTC). Tous les autres fuseaux horaires sont représentés par leur différence de l'UTC dans le format +hh:mm, ou -hh:mm. Si aucune valeur de fuseau horaire n'est présente, elle est considérée inconnue ; elle n'est pas considérée être UTC.
add-hours-to-time(Time as xs:time, Hours as xs:integer) asxs:time XP3.1 XQ3.1 Ajoute une durée en heures à une heure de temps. Le deuxième argument est le nombre d'heures à être ajouté à xs:time fourni en tant que le premier argument. Le résultat est de type xs:time.
|
add-minutes-to-time(Time as xs:time, Minutes as xs:integer) asxs:time XP3.1 XQ3.1 Ajoute une durée en minutes à une heure. Le deuxième argument est le nombre de minutes à être ajouté à xs:time fourni en tant que le premier argument. Le résultat est de type xs:time.
|
add-seconds-to-time(Time as xs:time, Minutes as xs:integer) asxs:time XP3.1 XQ3.1 Ajoute une durée en secondes à une heure. Le deuxième argument est le nombre de secondes à être ajouté à xs:time fourni en tant que le premier argument. Le résultat est de type xs:time. Le composant Secondes peut être contenu dans une plage de 0 à 59.999.
|
[ Haut ]
Supprimer la partie du fuseau horaire des types de données date/heures XP3.1 XQ3.1
Ces fonctions permettent de supprimer le fuseau horaire des valeurs xs:dateTime, xs:date ou xs:time actuelles, respectivement. Veuillez noter que la différence entre xs:dateTime et xs:dateTimeStamp est que dans le cas de ce dernier, la partie fuseau horaire est requise (alors qu'elle est optionnelle dans le premier des deux cas). Donc, le format d'une valeur xs:dateTimeStamp est : CCYY-MM-DDThh:mm:ss.sss±hh:mm. ou CCYY-MM-DDThh:mm:ss.sssZ. Si la date et l'heure sont lues depuis l'horloge du système, en tant que xs:dateTimeStamp, la fonction current-dateTime-no-TZ() peut être utilisée pour supprimer le fuseau horaire s'il est requis.
current-date-no-TZ() asxs:date XP3.1 XQ3.1 Cette fonction ne prend aucun argument. Elle supprime la partie fuseau horaire de current-date() (qui est la date actuelle selon l'horloge système) et retourne une valeur xs:date.
|
current-dateTime-no-TZ() asxs:dateTime XP3.1 XQ3.1 Cette fonction ne prend aucun argument. Elle supprime la partie fuseau horaire de current-dateTime() (qui est la date-heure actuelle selon l'horloge système) et retourne une valeurxs:dateTime.
|
current-time-no-TZ() asxs:time XP3.1 XQ3.1 Cette fonction ne prend aucun argument. Elle supprime la partie fuseau horaire de current-time() (qui est l'heure actuelle selon l'horloge système) et retourne une valeur xs:time.
|
date-no-TZ(InputDate as xs:date) asxs:date XP3.1 XQ3.1 Cette fonction prend un argument xs:date, en supprime la partie fuseau horaire et retourne une valeur xs:date. Veuillez noter que la date n'est pas modifiée.
|
dateTime-no-TZ(InputDateTime as xs:dateTime) asxs:dateTime XP3.1 XQ3.1 Cette fonction prend un argument xs:dateTime, en supprime la partie fuseau horaire, et retourne une valeur xs:dateTime. Veuillez noter que ni la date ni l'heure n'est modifiée.
|
time-no-TZ(InputTime as xs:time) as xs:time XP3.1 XQ3.1 This function takes an xs:time argument, removes the timezone part from it, and returns an xs:time value. Note that the time is not modified.
|
[ Haut ]
Retourne le nombre de jours, d'heures, de minutes, de secondes des durées XP3.1 XQ3.1
Ces fonctions retournent le nombre de jours dans un mois, et le nombre d'heures, de minutes et de secondes, respectivement depuis les durées.
days-in-month(Year as xs:integer, Month as xs:integer) asxs:integer XP3.1 XQ3.1 Retourne le nombre de jours dans le mois spécifié. Le mois est spécifié avec les arguments Year et Month.
|
minutes-from-dayTimeDuration-accumulated(DayAndTime as xs:duration) as xs:integer XP3.1 XQ3.1 Returns the total number of minutes in the duration submitted by the DayAndTime argument (which is of type xs:duration). The minutes in the Day and Time components are added together to give a result that is an integer. Negative durations result in a negative minute value.
|
seconds-from-dayTimeDuration-accumulated(DayAndTime as xs:duration) as xs:integer XP3.1 XQ3.1 Returns the total number of seconds in the duration submitted by the DayAndTime argument (which is of type xs:duration). The seconds in the Day and Time components are added together to give a result that is an integer. Negative durations result in a negative seconds value.
|
Retourne le jour de la semaine à partir de xs:dateTime ou xs:date XP3.1 XQ3.1
Ces fonctions retournent le jour de la semaine (en tant qu'entier) depuis xs:dateTime ou xs:date. Les jours de la semaine sont numérotés (format américain) de 1 à 7, avec Sunday=1. Dans le format européen, la semaine commence par Lundi (=1). Dans le format américain elle commence par Sunday=1. Configurer en utilisant l'entier 0 et où un entier est accepté pour indiquer le format.
weekday-from-dateTime(DateTime as xs:dateTime) asxs:integer XP3.1 XQ3.1 Prend une date-avec-heure en tant que son seul argument et retourne le jour de la semaine de cette date sous forme d'un entier. Les jours de la semaine sont numérotés en commençant avec Sunday=1. Si le format européen est requis (où Monday=1), utiliser l'autre signature de cette fonction (voir signature suivante ci-dessous).
weekday-from-dateTime(DateTime as xs:dateTime, Format as xs:integer) asxs:integer XP3.1 XQ3.1 Prend une date-avec-heure en tant que son premier argument et retourne le jour de la semaine de cette date sous forme d'un entier. Si le second argument (entier) est 0, les jours de la semaine sont numérotés de 1 à 7 en commençant avec Sunday=1. Si le second argument est un entier différent de 0, alors Monday=1. S'il n'y a pas de second argument, la fonction est lue comme possédant l'autre signature de cette fonction (voir signature précédente).
|
weekday-from-date(Date as xs:date) asxs:integer XP3.1 XQ3.1 Prend une date en tant que son seul argument et retourne le jour de la semaine de cette date sous forme d'un entier. Les jours de la semaine sont numérotés en commençant avec Sunday=1. Si le format européen est requis (où Monday=1), utiliser l'autre signature de cette fonction (voir signature suivante ci-dessous).
weekday-from-date(Date as xs:date, Format as xs:integer) asxs:integer XP3.1 XQ3.1 Prend une date en tant que son premier argument et retourne le jour de la semaine de cette date sous forme d'un entier. Si le second argument (Format) est 0, les jours de la semaine sont numérotés de 1 à 7 en commençant avec Sunday=1. Si le second argument est un entier différent de 0, alors Monday=1. S'il n'y a pas de second argument, la fonction est lue comme possédant l'autre signature de cette fonction (voir signature précédente).
|
[ Haut ]
Retourne le nombre de la semaine à partir de xs:dateTime ou xs:date XP2 XQ1 XP3.1 XQ3.1
Ces fonctions retournent le nombre de la semaine (en tant qu'entier) depuis xs:dateTime ou xs:date. La numérotation des semaines est disponible dans les formats de calendrier US, ISO/European et Islamiques. La numérotation des semaines est différente dans ces formats de calendrier parce que la semaine est considérée démarrer avec un jour différent selon le format (dimanche pour le format US, lundi pour le format ISO/Européen, et samedi dans le format islamique).
weeknumber-from-date(Date as xs:date, Calendar as xs:integer) asxs:integer XP2 XQ1 XP3.1 XQ3.1 Retourne le numéro de la semaine de l'argument Date soumis en tant qu'entier. Le deuxième argument (Calendar) spécifie le système de calendrier à suivre. Les valeurs de Calendar prises en charge sont :
• 0 = US calendar (semaine commence dimanche) • 1 = ISO standard, European calendar (semaine commence lundi) • 2 = Islamic calendar (semaine commence samedi)
Le réglage par défaut est 0.
|
weeknumber-from-dateTime(DateTime as xs:dateTime, Calendar as xs:integer) asxs:integer XP2 XQ1 XP3.1 XQ3.1 Retourne le numéro de la semaine de l'argument DateTime soumis en tant qu'entier. Le deuxième argument (Calendar) spécifie le système de calendrier à suivre. Les valeurs de Calendar prises en charge sont :
• 0 = US calendar (semaine commence dimanche) • 1 = ISO standard, European calendar (semaine commence lundi) • 2 = Islamic calendar (semaine commence samedi)
Le réglage par défaut est 0.
|
[ Haut ]
Construire le type de date, d'heure ou de durée à partir de leurs composants lexicaux XP3.1 XQ3.1
Les fonctions prennent les composants lexicaux du type de données xs:date, xs:time ou xs:duration en tant qu'arguments d'entrée et les combinent pour construire le type de données respectif.
build-date(Year as xs:integer, Month as xs:integer, Date as xs:integer) asxs:date XP3.1 XQ3.1 Les premier, second et troisième arguments sont respectivement l'année, le mois et la date. Ils sont combinés pour construire une valeur de type xs:date. Les valeurs de l'entier doivent se situer dans le cadre de la plage correcte de cette partie de la date. Par exemple, le deuxième argument (pour la partie du mois) ne devrait pas être supérieur à 12.
|
build-time(Hours as xs:integer, Minutes as xs:integer, Seconds as xs:integer) asxs:time XP3.1 XQ3.1 Les premiers, seconds et troisièmes arguments sont, respectivement, les valeurs d'heure (0 to 23), de minutes (0 to 59) et de secondes (0 to 59). Ils sont combinés pour construire une valeur de type xs:time. Les valeurs des entiers doivent se trouver dans le cadre de la plage correcte de cette partir de temps en particulier. Par exemple, le deuxième argument (Minutes) ne devrait pas être supérieur à 59. Pour ajouter une partie fuseau horaire à la valeur, utiliser l'autre signature de cette fonction (voir signature suivante).
build-time(Hours as xs:integer, Minutes as xs:integer, Seconds as xs:integer, TimeZone as xs:string) asxs:time XP3.1 XQ3.1 Les premiers, seconds et troisièmes arguments sont, respectivement, les valeurs d'heure (0 to 23), de minutes (0 to 59) et de secondes (0 to 59). Le quatrième argument est une chaîne qui fournit la partie fuseau horaire de la valeur. Les quatre arguments sont combinés pour construire une valeur de type xs:time. Les valeurs des entiers doivent se trouver dans le cadre de la plage correcte de cette partie de temps en particulier. Par exemple, le deuxième argument (Minutes) ne doit pas être supérieur à 59.
|
build-duration(Years as xs:integer, Months as xs:integer) asxs:yearMonthDuration XP3.1 XQ3.1 Prend deux arguments pour construire une valeur de type xs:yearMonthDuration. Les premiers arguments fournissent la partie Years de la valeur de durée, alors que le deuxième argument fournie la partie Months. Si le deuxième argument (Months) est supérieur ou égale à 12, alors l'entier est divisé par 12; le quotient est ajouté au premier argument pour fournir la partie Years de la valeur de durée alors que le reste (de la division) fournit la partie Months. Pour construire une durée de type xs:dayTimeDuration., voir la signature suivante.
build-duration(Days as xs:integer, Hours as xs:integer, Minutes as xs:integer, Seconds as xs:integer) as xs:dayTimeDuration XP3.1 XQ3.1 Prend quatre arguments et les combine pour construire une valeur de type xs:dayTimeDuration. Le premier argument fournit la partie Days de la valeur de durée, le deuxième, troisième et quatrième argument fournit respectivement les parties Hours, Minutes et Seconds de la valeur de durée. Chacun des trois arguments Time est converti en une valeur équivalente en termes de l'unité suivante plus élevée et le résultat est utilisé pour le calcul d'une valeur de durée totale. Par exemple, 72 secondes est converti en 1M+12S (1 minute et 12 secondes), et cette valeur est utilisée pour le calcul de la valeur de durée totale. Pour construire une durée de type xs:yearMonthDuration., voir la signature précédente.
|
[ Haut ]
Construire le type de date, dateHeure ou heure à partir de l'entrée de chaîne XP2 XQ1 XP3.1 XQ3.1
Ces fonctions prennent des chaînes en tant qu'arguments et construisent des types de données xs:date, xs:dateTime, ou xs:time. La chaîne est analysée pour les composants du type de données basé sur un argument de modèle soumis.
parse-date(Date as xs:string, DatePattern as xs:string) asxs:date XP2 XQ1 XP3.1 XQ3.1 Retourne la chaîne d'entrée Date en tant qu'une valeur xs:date. Le deuxième argument DatePattern spécifie le modèle (séquence des composants) de la chaîne d'entrée. DatePattern est décrit avec les spécificateurs de composants regroupés ci-dessous et avec les séparateurs de composant qui peuvent être n'importe quel caractère. Voir les exemples ci-dessous.
Le modèle dans DatePattern doit correspondre au modèle dans Date. Puisque la sortie est de type xs:date, la sortie aura toujours le format lexical YYYY-MM-DD.
|
parse-dateTime(DateTime as xs:string, DateTimePattern as xs:string) asxs:dateTime XP2 XQ1 XP3.1 XQ3.1 Retourne la chaîne d'entrée DateTime en tant que valeur xs:dateTime. Le deuxième argument DateTimePattern spécife le modèle (séquence des composants) de la chaîne d'entrée. DateTimePattern est décrit avec les spécificateurs de composants regroupés ci-dessous et avec les séparateurs de composant qui peuvent être n'importe quel caractère. Voir les exemples ci-dessous.
Le modèle dans DateTimePattern doit correspondre au modèle dans DateTime. Puisque la sortie est de type xs:dateTime, la sortie aura toujours le format lexical YYYY-MM-DDTHH:mm:ss.
|
parse-time(Time as xs:string, TimePattern as xs:string) asxs:time XP2 XQ1 XP3.1 XQ3.1 Retourne la chaîne d'entrée Time en tant qu'une valeur xs:time.Le deuxième argument TimePattern spécifie le modèle (séquence des composants) de la chaîne d'entrée. TimePattern est décrit avec les spécificateurs de composants regroupés ci-dessous et avec les séparateurs de composant qui peuvent être n'importe quel caractère. Voir les exemples ci-dessous.
Le modèle dans TimePattern doit correspondre au modèle dans Time. Puisque la sortie est de type xs:time, la sortie aura toujours le format lexical HH:mm:ss.
|
[ Haut ]
Fonctions liées à l'âge XP3.1 XQ3.1
Ces fonctions retournent l'âge tel que calculé (i) entre une date d'argument d'entrée et la date actuelle, ou (ii) entre deux dates d'argument d'entrée. La fonction altova:age retourne l'âge en termes d'années, la fonction altova:age-details retourne l'âge en tant qu'une séquence de trois entiers indiquant les années, mois et jours de l'âge.
age(StartDate as xs:date) asxs:integer XP3.1 XQ3.1 Retourne un entier représentant l'âge en années d'un objet, en comptant depuis une date de départ soumise en tant que l'argument et se terminant avec la date actuelle (prise depuis l'horloge système). Si l'argument d'entrée est une date supérieure ou égale à une année dans le futur, la valeur de retour sera négative.
age(StartDate as xs:date, EndDate as xs:date) asxs:integer XP3.1 XQ3.1 Retourne un entier représentant l'âge en années d'un objet, en comptant depuis une date de départ soumise en tant que l'argument jusqu'à une date de fin qui est de deuxième argument. La valeur de retour sera négative si le premier argument est tardif d'une année ou plus que le deuxième argument.
|
age-details(InputDate as xs:date) as (xs:integer)* XP3.1 XQ3.1 Retourne trois entiers qui sont respectivement les années, les mois et les jours entre la date soumise en tant que l'argument et la date actuelle (prise depuis l'horloge système). Le résultat de la somme de years+months+days donne le total de la différence de temps entre les deux dates (la date d'entrée et la date actuelle). La date d'entrée peut avoir une valeur précédant ou succédant à la date actuelle mais que la date d'entrée soit précédente ou succédant n'est pas indiqué par le signe des valeurs de retour ; les valeurs de retour sont toujours positives.
age-details(Date-1 as xs:date, Date-2 as xs:date) as (xs:integer)* XP3.1 XQ3.1 Retourne trois entiers qui sont respectivement les années, les mois et les jours entre les deux dates d'argument. Le résultat de la somme de years+months+days donne le total de la différence de temps entre les deux dates d'entrée ; peu importe que la date soit la précédente ou la subséquente des deux dates, elle est soumise en tant que le premier argument. Les valeurs de retour n'indiquent pas si la date d'entrée se produit avant ou après la date actuelle. Les valeurs de retour sont toujours positives.
|
[ Haut ]
Fonctions Epoch time (heure Unix) XP3.1 XQ3.1
Epoch time est un système horaire utilisé dans les systèmes Unix. Il définit tout moment donné comme étant le nombre de secondes écoulées depuis 00:00:00 UTC le 1er janvier 1970. Ces fonctions Epoch time convertissent les valeurs xs:dateTime en valeurs Epoch time et vice versa.
dateTime-from-epoch(Epoch as xs:decimal as xs:dateTime XP3.1 XQ3.1 Epoch time est un système horaire utilisé sur les systèmes Unix. Il définit tout moment donné comme étant l nombre de secondes écoulées depuis 00:00:00 UTC le 1er janvier 1970. La fonction dateTime-from-epoch retourne l'équivalent xs:dateTime d'un Epoch time, l'ajuste pour son fuseau horaire local et inclut l'information du fuseau horaire dans le résultat.
La fonction prend un argument xs:decimal et retourne une valeur xs:dateTime qui inclut une partie (fuseau horaire) TZ. Le résultat est obtenu en calculant l'équivalent UTC dateTime de Epoch time, et en l'ajoutant à son fuseau horaire local (pris de l'horloge système). Par exemple, si la fonction est exécutée sur un appareil qui a été défini pour être dans un fuseau horaire +01:00 (relatif à UTC), après avoir calculé l'équivalent UTC dateTime, une heure sera ajoutée au résultat. L'information du fuseau horaire, qui est une partie lexicale optionnelle du résultat xs:dateTime, est également rapportée dans le résultat dateTime. Comparez ce résultat avec celui de dateTime-from-epoch-no-TZ, et consultez également la fonction epoch-from-dateTime.
|
dateTime-from-epoch-no-TZ(Epoch as xs:decimal as xs:dateTime XP3.1 XQ3.1 Epoch time est un système horaire utilisé sur les systèmes Unix. Il définit tout moment donné comme étant l nombre de secondes écoulées depuis 00:00:00 UTC le 1er janvier 1970. La fonction dateTime-from-epoch-no-TZ retourne l'équivalent xs:dateTime d'un Epoch time, l'ajuste pour son fuseau horaire local, mais n'inclut pas l'information du fuseau horaire dans le résultat.
La fonction prend un xs:decimal argument et retourne une valeur xs:dateTime qui n'inclut pas de partie (fuseau horaire) TZ. Le résultat est obtenu en calculant l'équivalent UTC dateTime de Epoch time, et en l'ajoutant à son fuseau horaire local (pris de l'horloge système). Par exemple, si la fonction est exécutée sur un appareil qui a été défini pour être dans un fuseau horaire +01:00 (relatif à UTC), après avoir calculé l'équivalent, une heure sera ajoutée au résultat. L'information du fuseau horaire, qui est une partie lexicale optionnelle du résultat xs:dateTime, n'est pas rapportée dans le résultat dateTime. Comparez ce résultat avec celui de dateTime-from-epoch, et consultez également la fonction epoch-from-dateTime.
|
epoch-from-dateTime(dateTimeValue as xs:dateTime) as xs:decimal XP3.1 XQ3.1 Epoch time est un système horaire utilisé sur les systèmes Unix. Il définit tout moment donné comme étant l nombre de secondes écoulées depuis 00:00:00 UTC le 1er janvier 1970. La fonction epoch-from-dateTime retourne l'équivalent xs:dateTime d'un Epoch time, l'ajuste pour son fuseau horaire local et inclut l'information du fuseau horaire dans le résultat. Veuillez noter que vous devrez explicitement construire la valeur xs:dateTime. La valeur soumise xs:dateTime peut ou ne peut pas contenir la partie optionnelle TZ (fuseau horaire).
Que la partie du fuseau horaire soit soumise en tant que partie de l'argument ou non, le décalage du fuseau horaire local (pris de l'horloge système) est retiré de l'argument soumis dateTimeValue. Ceci porduit l'heure UTC équivalente de laquelle l'Epoch time équivalent est calculé. Par exemple, si la fonction est exécutée sur un appareil qui a été défini pour être dans un fuseau horaire +01:00 (relatif à UTC), une heure sera retirée de la valeur soumise dateTimeValue avant de calculer la valeur Epoch. Consultez également la fonction dateTime-from-epoch.
|
[ Haut ]