Campus Livre
timerange
Seleciona as linhas de uma timetable que estão dentro de um intervalo de tempo.
Categoria: Language Fundamentals > Data Types
Sintaxe
S = timerange(t1, t2)Subscrito que seleciona tempos de linha de t1 até t2, sem incluir t2.
S = timerange(t1, t2, intervalType)Escolhe quais extremos são incluídos: 'openright' (padrão), 'closed', 'open' ou 'openleft'.
Descrição
timerange retorna um objeto de subscrito, não dados. Só faz sentido dentro dos parênteses de uma timetable. Por padrão o intervalo é fechado à esquerda e aberto à direita, então timerange(seconds(2), seconds(3)) seleciona a linha em 2 s, mas não a de 3 s. Informe 'closed' para incluir os dois extremos.
Argumentos de entrada
t1, t2- Início e fim do intervalo, como valores datetime ou duration compatíveis com os tempos das linhas.
intervalType- Quais dos dois extremos pertencem ao intervalo.
Argumentos de saída
S- Subscrito baseado em tempo para usar entre parênteses com uma timetable, por exemplo
TT(timerange(a, b), :).
Exemplo
Extremo direito aberto e intervalo fechado
t = datetime(2024,1,1) + days(0:4)';
TT = timetable(t, (1:5)', 'VariableNames', {'v'});
TT(timerange(datetime(2024,1,2), datetime(2024,1,4)), :)
TT(timerange(datetime(2024,1,2), datetime(2024,1,4), 'closed'), :)Saída
ans = 2×1 timetable
t v
___________ _
02-Jan-2024 2
03-Jan-2024 3
ans = 3×1 timetable
t v
___________ _
02-Jan-2024 2
03-Jan-2024 3
04-Jan-2024 4