Convertit les données de temps en temps relatif.

Syntaxe

Temps relatif[<Y|X|Z>] Objet de données

ou

RelativeTimeStrict[<Y|X|Z>] Objet de données

La syntaxe de l'opérateur RelativeTime se compose des éléments suivants :

Remarques

La conversion en temps relatif s'effectue en soustrayant l'horodatage de l'objet de données dans l'onglet Général de la boîte de dialogue Propriétés pour le composant de données à convertir.

La variante RelativeTimeStrict de l'opérateur renvoie une erreur lors de la compilation de la formule si Expression est une expression FPScript qui ne fournit pas d'objet de données. Lors de l'exécution de la formule, cette variante émet une erreur si le composant d'objet de données concerné ne possède pas d'horodatage. La variante RelativeTime ignore les deux erreurs et ne modifie pas l'argument.

L'opérateur peut traiter toutes les structures de données et les types de données réelles. Les listes sont traitées élément par élément. Si un composant est ajouté à l'opérateur, comme dans RelativeTime<X>, seul le composant pertinent est traité dans les structures de données agrégées et les données des autres composants restent inchangées dans le résultat. Si aucun composant n'est annexé, tous les composants sont traités. Pour les structures de données non agrégées, RelativeTime<Y> est équivalent à RelativeTime et RelativeTime<X> ainsi que RelativeTime<Z> n'ont aucun effet.

Si le composant de données concerné est déjà en temps relatif, c'est-à-dire qu'il n'est pas du type temps calendaire, il sera copié sans modification. Si Expression ne dispose pas d'un horodatage pour le composant à convertir, la première valeur de l'ensemble de données sera soustraite de toutes les données à la place, c'est-à-dire que la première valeur se verra attribuer le temps relatif de t = 0. Si l'opérateur est utilisé pour un composant particulier, que l'expression ne comporte pas de timestamp pour la composante à convertir et que la première valeur de l'ensemble de données est également invalide, une erreur sera émise. Si le gestionnaire d'unités est activé, il vérifiera si l'unité de composant de données a le temps comme dimension. Si ce n'est pas le cas, aucune conversion n'aura lieu et il sera copié dans le résultat sans modification.

Comme l'opérateur doit extraire l'horodatage de l'expression, n'importe quelle expression n'est pas autorisée comme argument. Seules les expressions qui représentent un objet de données ou auxquelles sont attribuées des informations d'en-tête sont autorisées.

Disponible dans

FlexPro View, Basic, Professional, Developer Suite

Exemples

Voir aussi

Horodatage

Opérateur AbsoluteTime