datetime-from-parts
Retourne une valeur de type xs:dateTime construite depuis n’importe quelle combinaison des parties suivantes en tant qu’arguments : annéer, mois, jour, heure, minute, seconde, milliseconde et fuseau horaire. Cette fonction normalise automatiquement les paramètres fournis. Par exemple, le 32 janvier sera changé automatiquement en 1er février.
Langages
Built-in, C++, C#, Java.
Paramètres
Nom | Type | echo Hello, World! |
|---|---|---|
year | xs:int | Fournit l’année. |
month | xs:int | Fournit le mois. |
day | xs:int | Fournit le jour du mois. |
hour | xs:int | Optionnel Fournit l’heure. |
minute | xs:int | Optionnel Fournit la minute. |
second | xs:int | Optionnel Fournit la seconde. |
millisecond | xs:decimal | Optionnel Fournit la milliseconde. |
timezone | xs:int | Optionnel Fournit le fuseau horaire, en minutes. Cette valeur peut être négative. |
Exemple
Le mappage suivant construit une valeur xs:dateTime provenant de parties qui sont fournies par des constantes.
La sortie de mappage est 2020-04-17T08:58:54.333-01:00.
Pour consulter un autre exemple, voir le mappage IDoc_Order.mfd provenant du dossier <Documents>\Altova\MapForce2025\MapForceExamples\. Ce mappage illustre comment lire des données provenant des fichiers d’instance SAP IDoc. Il contient une fonction définies par l'utilisateur "convertIDOCDate" qui assembles la valeur xs:dateTime depuis deux strings d’entrée, en utilisant les fonctions left-trim et substring.
Les composants dateString et timeString sont des paramètres dans la fonction définie par l'utilisateur. Ils sont fournis par le mappage principal, depuis le fichier d’instance SAP IDoc :
Dans ce mappage, la valeur de date en tant que string est 19990621. La valeur de temps est 0930. Par conséquent, la fonction datetime-from-parts retourne la valeur 1999-06-21T09:30:00. Cette valeur est aussi le résultat de la fonction définie par l'utilisateur et est écrite dans l’item Received du document XML de cible.