Saltar navegación

Documentación de FlexPro 2025

NextTimePeriod

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:

Constante

Significado

SECOND

Segundo en el minuto (0,0 a 59,9999)

MINUTE

Minuto en la hora (0.0 a 59.9999)

HOUR

Hora del día (0.0 a 23.9999)

DAY

Día del mes (del 1 al 31)

WEEKDAY

Día de la semana (0 para domingo a 6 para sábado, en lugar de valores numéricos también puede utilizar las constantes SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY y SATURDAY)

MONTH

Mes del año (1 a 12)

YEAR

Año (1970 a 3000)

DAYOFYEAR

Aniversario (1 a 366)

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:

Constante

Significado

EVENT_RIGHT

Buscar a la derecha.

EVENT_LEFT

Buscar a la izquierda.

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.

Véase también

Función TimePeriods

Función NextValueInInterval

Función NextValueAboveLevel

Función NextValueBelowLevel

Función ValuesAboveLevel

Función ValuesBelowLevel

Función ValuesInInterval

Objeto de análisis Aislamiento de eventos