Busca en un conjunto de datos con valores de tiempo del calendario el siguiente valor que se encuentra en un segmento temporal periódica.
Sintaxis
NextTimePeriod(DataSet, Criterion, [ Position ], LowerBound, UpperBound [ , Direction = EVENT_RIGHT ])
La sintaxis de la función NextTimePeriod consta de los siguientes elementos:
Parte |
Descripción |
||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DataSet |
El conjunto de datos con valores de tiempo del calendario en el que desea buscar períodos. Las estructuras de datos permitidas son Serie de datos, Señal y Serie de señales. Se permiten todos los tipos de datos numéricos. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||||||||||||||
Criterion |
Especifica en qué elemento de fecha debe basarse la búsqueda. El argumento Criterion puede tener los siguientes valores:
Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||||||||
Position |
Si busca en una señal, es el valor X a partir del cual quiere buscar. El valor en sí no se incluye en la búsqueda. Si busca en una serie de datos, es el índice del valor a partir del cual quiere buscar. El índice en sí no se incluye en la búsqueda. Un índice negativo determina una posición relativa al final del conjunto de datos. Si omite el argumento o transmite el valor Empty, la búsqueda comienza al incio o al final del conjunto de datos, dependiendo de la dirección de búsqueda. El primer o último valor del conjunto de datos solo se tiene en cuenta si se omite el argumento o se transmite el valor Empty. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos numéricos. La unidad debe ser compatible con la del parámetro DataSet. En los tipos de datos complejos se calcula un valor absoluto. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||||||||||||||
LowerBound |
Especifica el límite inferior del rango de tiempo. Si introduce un valor con una unidad, esta debe coincidir con el elemento de fecha seleccionado. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||||||||||||||
UpperBound |
Especifica el límite superior del rango de tiempo. Si introduce un valor con una unidad, esta debe coincidir con el elemento de fecha seleccionado. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||||||||||||||
Direction |
Define la dirección de búsqueda de la función. El argumento Direction puede tener los siguientes valores:
Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. Se establece el valor predeterminado EVENT_RIGHT si no se especifica el argumento. |
Notas
El resultado es siempre el tipo de datos Tiempo de calendario.
En el componente X se buscan señales y series de señales.
En caso de que LowerBound sea menor o igual que UpperBound, un valor está en el intervalo si es mayor o igual que LowerBoundy menor o igual que UpperBound. Si se especifica LowerBound como mayor que UpperBound, un valor está en el intervalo si es mayor o igual que UpperBoundo menor o igual que LowerBound es. Esto corresponde aproximadamente a la formación de un complemento.
Para los elementos de fecha SECOND, MINUTE y HOUR, puede especificar los límites del intervalo como un número en coma flotante.
Disponibilidad
FlexPro Basic, Professional, Developer Suite
Ejemplos
NextTimePeriod(TimeSignal, SECOND, , 3.5, 12.3) |
Devuelve el índice del primer valor de la señal 'TimeSignal', que se encuentra en el intervalo [3.5, 12.3] segundos en cada minuto. |
TimeSignal[[NextTimePeriod(TimeSignal, SECOND, 5.5 s, 200 ms, 600 ms, EVENT_LEFT)]] |
Busca en la señal 'TimeSignal' desde la posición X = 5.5 s hacia la izquierda el siguiente valor, que se encuentra en el intervalo [0.2, 0.6] segundos en cada minuto. El resultado es el valor Y en la posición encontrada. |