DateTimeCalculator

Effectue des calculs arithmétiques sur des valeurs de date, d'heure, de temps et d'intervalle. Dans le mode Expression avancée, des expressions composées sur les dates et les intervalles peuvent être construites.

Consulter la section : Terminologie Date/Heure, Format de Date/heure, Fonction Date/Heure

DateTimeCalculator permet des opérations arithmétiques selon cinq temporalités :

Date
Heure
Temps avec décalage UTC
Date-Heure
Date-Heure avec décalage UTC

La chaîne temporelle entrante doit être au format FME ou ISO 8601.

DateTimeCaluclator supporte aussi les intervalles arithmétiques quand l'intervalle peut être spécifié d'une de ces façons :

Spécifié par la partie. Par exemple, l'utilisateur peut spécifier 5 pour la valeur de "Années".
Spécifié par une chaîne d'intervalle dans le format durée ISO 8601.

Les entrées de temps et d'intervalles invalides feront que les fonctions Date-Heure les utilisant retourneront null et causeront le rejet de l'entité.

Limites :

Plage temporelle supportée : 1000-01-01 00:00:00.000000000 à 9999-12-31 23:59:59.999999999.
Seul le délimiteur "." n'est supporté, quand la valeur en entrée contient des fractions de secondes.
Lorsqu'on soustrait une valeur temporelle d'une autre, les deux valeurs temporelles doivent avoir des types temporels compatibles, sinon l'entité sera rejetée. Veuillez consulter la matrice de compatibilité des types.
Si un intervalle est spécifié par parties, alors les valeurs des parties doivent toutes être positives ou toutes être négatives, sinon l'entité sera rejetée.

Configuration

Ports d'entrée

Ports de sortie

Note L'Ordre des entités peut changer selon les ports de sortie. L'ordre des entités par port est maintenu.

Paramètres

Méthode

Spécifier l'opération à réaliser :

Ajouter ou soustraire un intervalle : ajouter ou soustraire un intervalle à une valeur temporelle. L'intervalle est spécifié par partie. C'est-à-dire par année, mois, jour, heure, minute et fraction de seconde. Seules les secondes sont autorisées à être fractionnées. Les autres parties sont des entiers. Les parties doivent être toutes non négatives ou toutes non positives, sinon l'entité est rejetée. Le résultat a le même type temporel que le type temporel d'entrée.
Ajouter ou soustraire un intervalle (durée ISO) : ajoute ou soustrait un intervalle à une valeur temporelle. L'intervalle est spécifié au format de durée ISO 8601. Le résultat a le même type temporel que le type temporel d'entrée.
Calculer un intervalle entre deux dates : l'heure de fin moins l'heure de début produit un intervalle. L'utilisateur peut choisir de produire l'intervalle au format de durée ISO 8601, ou sous forme de fraction d'année, de mois, de semaine, de jour, d'heure, de minute ou de seconde.
Expressions avancées : des fonctions avancées peuvent être utilisées pour construire des expressions composées telles que @DateTimeAdd(time1, @DateTimeDiff(@Value(time2) – @Value(time3)).

Général

Paramètres Ajouter ou soustraire un intervalle	Spécifiez une valeur temporelle de départ. Choisissez d'ajouter ou de soustraire un intervalle. Ensuite, spécifiez les valeurs des parties de l'intervalle qui vous intéressent. Les parties d'intervalle prises en charge sont les années, les mois, les jours, les heures, les minutes et les secondes. Le paramètre des secondes peut être fractionnaire. Les autres valeurs de partie doivent être des entiers. Note Les décimales pour ce type de champs sont arrondis pour devenir des entiers.
Paramètres Ajouter ou soustraire un intervalle (Durée ISO)	Spécifiez une valeur temporelle de départ. Choisissez d'ajouter ou de soustraire un intervalle. Ensuite, spécifiez l'intervalle avec le format de durée ISO 8601.
Calcule l'intervalle entre les paramètres Dates.	Spécifiez les valeurs temporelles de début et de fin. Ensuite, choisissez le type d'intervalle de sortie. Les types d'intervalles pris en charge sont les suivants : Durée ISO 8601 Années fractionnées, calculées comme le nombre de mois fractionnés, divisés par 12. Mois fractionnés : entre une date de début et une date de fin, il y a un certain nombre de mois complets. Le reste qui n'est pas un mois complet est constitué d'un certain nombre de jours, d'heures, de minutes et de secondes. Le reste commence dans un mois que l'on appelle "mois restant". Le reste est d'abord converti en jours fractionnaires. Ensuite, les jours fractionnés sont divisés par le nombre de jours du mois restant. Le mois restant est le mois qui précède immédiatement (et qui contient une partie ou la totalité) du reste, ce qui garantit que le reste n'est jamais supérieur à un mois, lorsqu'il est exprimé sous forme de mois fractionné. Enfin, le reste sous forme de fraction de mois est ajouté au nombre de mois complets, ce qui donne les fractions de mois résultantes. Par exemple, depuis le 2016-Jan-011 (début) jusqu'au 2017-Mars-31 (fin), il y a 1 an et 2 mois plus un reste. 2016-Jan-01 + 1 an + 2 mois nous amène au 2017-Mar-01, ce qui signifie que le le mois restant est 2017-Mar. Ce mois possède 31 jours. Le reste est donc de 30 jours et est divisé par 31 pour obtenir le mois fractionnel. Le nombre total de mois entre les deux dates est donc de 1 an (12 mois) + 2 mois + 30/31 mois = 14.967742. Semaines, jours, heures, minutes, secondes : pour chacun de ces paramètre, un calcul de la durée est effectué en secondes fractionnées. La conversion se fait alors dans l'unité spécifiée. Il y a 60 secondes dans une minute. 60 minutes dans une heure, 24 heures dans un jour et 7 jours dans une semaine. Note Pour ré-utiliser des années, mois, semaines, jours, heures ou minutes fractionnées dans DateTimeCalculator ou via @DateTimeAdd(), arrondir ou tronquer les valeurs en entiers. Conseil Les années, mois, semaines, jours, heures, minutes ou secondes fractionnées en peuvent être utiles pour des comparaison ou des rapports.
Expressions avancées	Construit des expressions FME composées impliquant les notions de durée et de temps, par exemple : @DateTimeAdd(@Value(newStartDate),@DateTimeDiff(@Value(projEnd),@Value(projStart)) @DateTimeCast(@DateTimeNow(),time) @DateTimeFormat(@DateTimeParse(@Value(sourceString),@Value(inputFormat)),@Value(outputFormat)) Consulter la section Fonctions FME Date/Time .

Éditer les paramètres des Transformers

À l'aide d'un ensemble d'options de menu, les paramètres du Transformer peuvent être attribués en faisant référence à d'autres éléments de traitement. Des fonctions plus avancées, telles qu'un éditeur avancé et un éditeur arithmétique, sont également disponibles dans certains Transformers. Pour accéder à un menu de ces options, cliquez sur à côté du paramètre applicable. Pour plus d'informations, voir Options de menus et paramètres de Transformer.

Définir les valeurs

Il existe plusieurs façons de définir une valeur à utiliser dans un Transformer. La plus simple est de simplement taper une valeur ou une chaîne de caractères, qui peut inclure des fonctions de différents types comme des références d'attributs, des fonctions mathématiques et de chaînes de caractères, et des paramètres de traitement. Il existe un certain nombre d'outils et de raccourcis qui peuvent aider à construire des valeurs, généralement disponibles dans le menu contextuel déroulant adjacent au champ de valeur.

Définir des valeurs de paramètres

Utilisation de l'éditeur de texte

L'éditeur de texte fournit un moyen efficace de construire des chaînes de textes (dont les expressions régulières) à partir de données source diverses, telles que des attributs, des paramètres et des constantes, et le résultat est directement utilisé dans le paramètre.

Editeur de texte

Utilisation de l'éditeur arithmétique

L'éditeur arithmétique fournit un moyen simple de construire des expressions mathématiques à partir de plusieurs données source, telles que des attributs et des fonctions, et le résultat est directement utilisé dans un paramètre.

Éditeur arithmétique

Valeur conditionnelle

Définit des valeurs selon un ou plusieurs tests.

Fenêtre de définition de conditions

Contenu

Les expressions et chaînes de caractères peuvent inclure des fonctions, caractères, paramètres et plus.

Lors du paramétrage des valeurs - qu'elles soient entrées directement dans un paramètre ou construites en utilisant l'un des éditeurs - les chaînes de caractères et les expressions contenant des fonctions Chaîne de caractères, Math, Date et heure ou Entité FME auront ces fonctions évaluées. Par conséquent, les noms de ces fonctions (sous la forme @<nom_de_fonction>) ne doivent pas être utilisés comme valeurs littérales de chaîne de caractères.

Types de contenu

Fonctions chaînes de caractères	Ces fonctions manipulent les chaînes de caractères.
Caractères spéciaux	Un ensemble de caractères de contrôle est disponible dans l'éditeur de texte.
Fonctions mathématiques	Plusieurs fonctions sont disponibles dans les deux éditeurs.
Fonctions Date/heure	Les fonctions de dates et heures sont disponibles dans l'Editeur texte.
Opérateurs mathématiques	Ces opérateur sont disponibles dans l'éditeur arithmétique.
Fonctions d'entités	Elles retournent des valeurs spécifiques aux entités.
Paramètres FME	Les paramètres FME et spécifiques au traitement peuvent être utilisés.
Créer et modifier un paramètre publié	Créer ses propres paramètres éditables.

Options - Tables

Les Transformers avec des paramètres de style table possèdent des outils additionnels pour remplir et manipuler des valeurs.

Outils de tableau

Réordonner

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

Ajouter une ligne
Supprimer une ligne
Déplacer la ligne en cours au dessus
Déplacer la ligne en cours en dessous
Déplacer la ligne en cours en haut de liste
Déplacer la ligne en cours en bas de liste

Couper, Copier et Coller

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

Couper une ligne - supprime et copie dans le presse-papiers.
Copie une ligne dans le presse-papiers.
Colle une ligne depuis le presse-papiers.

Copier, copier et coller peuvent être utilisés au sein d'un Transformer ou entre Transfromers.

Filtre

Commencez à taper une chaîne de caractères, et la matrice n'affichera que les lignes correspondant à ces caractères. Recherche dans toutes les colonnes. Cela n'affecte que l'affichage des attributs dans le Transformer - cela ne change pas les attributs qui sont sortis.

Importer

Le bouton d'import remplit la table avec un jeu de nouveaux attributs lus depuis un jeu de données. L'application spécifique varie selon les Transformers.

Réinitialiser/Rafraîchir

Réinitialise la table à son état initial, et peut fournir des options additionnelles pour supprimer des entrées invalides. Le comportement varie d'un Transformer à l'autre.

Note : Tous les outils ne sont pas disponibles dans tous les Transformers.

FME Community

FME Community est l'endroit où trouver des démos, des tutoriaux, des articles, des FAQ et bien plus encore. Obtenez des réponses à vos questions, apprenez des autres utilisateurs et suggérez, votez et commentez de nouvelles entités.

Voir tous les résultats à propos de ce Transformer sur FME Community.