RelativeTime, RelativeTimeStrict
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 :
Élément |
Description |
|---|---|
Expression |
Un objet de données ou une expression qui fournit des données avec des informations d'en-tête. |
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
Temps relatif<X>Signal |
Convertit la composante X du signal en temps relatif. |
Temps relatifSignal |
Convertit toutes les composantes du signal avec une unité de temps en temps relatif. |
Temps relatif<X>Signal(Amplitude, Temps) |
Génère un message d'erreur, car l'argument opérateur ne représente pas un objet de données. |