RingBufferReadTime (FPScript)
Lit une section d'une trace temporelle à partir d'un ring buffer HistoryBase.
Syntaxe
RingBufferReadTime(HistoryBaseFile, Machine, FromTime, ToTime, [ CalendarTime = TRUE ] [ , SubRate = 1 ])
La syntaxe de la fonction RingBufferReadTime se compose des éléments suivants :
Section |
Description |
---|---|
HistoryBaseFile |
Chemin d'accès au fichier ring buffer HistoryBase à lire. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères (nom du fichier). |
Machine |
Nom de l'ordinateur du réseau sur lequel est exécuté le serveur ring buffer HistoryBase. Cet argument peut également être un texte vide. Dans ce cas, l'instance HistoryBase du ring buffer sera recherchée ou, si nécessaire, instanciée sur la machine d'exécution. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. |
FromTime |
La date et l'heure de la première (la plus ancienne) valeur temporelle à lire. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Entier de 32 bits, Virgule flottante de 64 bits et Temps calendaire. |
ToTime |
La date et l'heure de la dernière valeur temporelle (la plus récente) à lire. Cette date et cette heure doivent être supérieures à la date et à l'heure spécifiées dans FromTime. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Entier de 32 bits, Virgule flottante de 64 bits et Temps calendaire. |
CalendarTime |
Valeur booléenne précisant que les données de temps doivent être lues comme des temps calendaire. Sinon, l'heure est indiquée en secondes lorsque FromTime correspond à zéro. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut TRUE . |
SubRate |
Valeur entière qui spécifie le sous-échantillonnage. Le temps est réduit en fonction du sous-échantillonnage donné pour renvoyer les valeurs de temps d'une trace appartenant à un groupe ayant un sous-échantillonnage. Ce paramètre n'est évalué que lorsque l'on travaille avec HistoryBase 3 ou plus. Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés. La valeur doit être supérieure ou égale à 1. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut 1 . |
Remarques
Le résultat a toujours la structure de données Séries de données.
Le ring buffer Weisang HistoryBase version 2.4 ou supérieur doit être installé sur le système d'exécution et, le cas échéant, sur le système spécifié par Machine. Le résultat est fourni au format de l'heure UTC.
Si un argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
RingBufferReadTime("C:\RingBuffer.rbf", "RemoteMachine", '2010/1/1 10:00', '2010/1/1 11:00') |