Saltar navegación

Documentación de FlexPro 2025

TimePeriods

Busca en un conjunto de datos con valores de tiempo del calendario según las secciones de tiempo periódicas.

Sintaxis

TimePeriods(DataSet, Criterion, LowerBound, UpperBound [ , Operation = EVENT_DEFAULT ])

 

La sintaxis de la función TimePeriods 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, Matriz de datos, Señal, Serie de señales y Serie de señales con componente X bidimensional. 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.

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.

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.

Operation

Define el método de operación de la función.

El argumento Operation puede tener los siguientes valores:

Constante

Significado

EVENT_INDEX

Los índices de los valores o puntos que corresponden a la condición se almacenan en el conjunto de datos resultante.

EVENT_EXTRACT

Sólo los puntos o valores que cumplen la condición se transfieren al conjunto de datos de resultante.

EVENT_SETVOID

Los puntos o valores que no cumplen la condición se transfieren al conjunto de datos resultante, pero se marcan como no válidos.

EVENT_DEFAULT

Corresponde a EVENT_SETVOID si existe una matriz de datos o una serie de señales, y en caso contrario EVENT_INDEX.

+ EVENT_COMPLEMENT

Esta constante puede añadirse opcionalmente e invierte la operación seleccionada. Por ejemplo EVENT_EXTRACT se transfieren los puntos que no corresponden a la condición.

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_DEFAULT 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

TimePeriods(TimeSignal, SECOND, 3.5, 12.3)

Devuelve los índices de los valores de la señal 'TimeSignal' que se encuentran en el intervalo [3.5, 12.3] segundos en cada minuto.

TimePeriods(TimeSignal, SECOND, 200 ms, 600 ms)

Devuelve los índices de los valores de la señal 'TimeSignal' que se encuentran en el intervalo [0.2, 0.6] segundos en cada minuto.

TimePeriods(SignalSeries, WEEKDAY, MONDAY, FRIDAY, EVENT_SETVOID)

Devuelve la serie de señales en la que se han invalidado todos los valores Y que caen en fin de semana.

IndexAnd(TimePeriods(TimeSignal, WEEKDAY, MONDAY, FRIDAY), TimePeriods(TimeSignal, HOUR, 9.0, 17.5))

Devuelve los índices de los valores de la señal 'TimeSignal' que caen en un día laborable y se encuentran en el rango de 9:00 a 17:30.

Véase también

Función NextTimePeriod

Función PositivePeaks

Función NegativePeaks

Función LevelCrossings

Función ValuesAboveLevel

Función ValuesBelowLevel

Función ValuesInInterval

Objeto de análisis Aislamiento de eventos