getsampleusingtime

timeseries 또는 tscollection 데이터의 서브셋

구문

tsout = getsampleusingtime(tsin,timeval)

tsout = getsampleusingtime(tsin,timeval,'AllowDuplicateTimes',true)

tsout = getsampleusingtime(tsin,starttime,endtime)

설명

tsout = getsampleusingtime(tsin,timeval)은 시간 timeval에 대응하는 입력 timeseries 또는 tscollection의 데이터 샘플 하나를 반환합니다. tsout은 tsin과 객체 유형이 동일합니다.

tsout = getsampleusingtime(tsin,timeval,'AllowDuplicateTimes',true)는 timeval에 지정된 동일한 시간 값을 갖는 여러 개의 데이터 샘플을 포함합니다.

tsout = getsampleusingtime(tsin,starttime,endtime)은 starttime 시간과 endtime 시간 사이의 tsin 샘플을 포함합니다.

예제

timeseries의 서브셋 추출하기

timeseries 객체를 만들고 2~4번째 시간 값에 해당하는 데이터 샘플을 추출합니다.

tsin = timeseries((1:5)',1:5);
tsout = getsampleusingtime(tsin,2,4);
tsout.Data

ans = 3×1

     2
     3
     4

tscollection의 서브셋

두 timeseries 객체에서 tscollection 객체를 만들고 2번째 시간 값에서 4번째 시간 값까지에 대응하는 데이터 샘플을 추출합니다.

ts1 = timeseries(rand(5,1),'Name','ts1');
ts2 = timeseries(rand(5,1),'Name','ts2');
tscin = tscollection({ts1,ts2});

tscout = getsampleusingtime(tscin,2,4);
tscout.Time

ans = 3×1

     2
     3
     4

입력 인수

tsin — 입력 시계열

timeseries 객체 | tscollection 객체

입력 시계열로, timeseries 또는 tscollection 객체로 지정됩니다.

timeval — 샘플 시간

스칼라 | 벡터

샘플 시간으로, 숫자형 스칼라, 날짜 문자형 벡터 또는 datenum 스칼라로 지정됩니다. 유효한 날짜 문자형 벡터의 형식은 다음과 같습니다.

형식	예
dd-mmm-yyyy HH:MM:SS	01-Mar-2000 15:45:17
dd-mmm-yyyy	01-Mar-2000
mm/dd/yy	03/01/00
mm/dd	03/01
HH:MM:SS	15:45:17
HH:MM:SS PM	3:45:17 PM
HH:MM	15:45
HH:MM PM	3:45 PM
mmm.dd,yyyy HH:MM:SS	Mar.01,2000 15:45:17
mmm.dd,yyyy	Mar.01,2000
mm/dd/yyyy	03/01/2000

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | cell

starttime — 시작 시간

스칼라 | 벡터

시작 시간으로, 숫자형 스칼라, 날짜 문자형 벡터 또는 datenum 스칼라로 지정됩니다.

endtime — 종료 시간

스칼라 | 벡터

종료 시간으로, 숫자형 스칼라, 날짜 문자형 벡터 또는 datenum 스칼라로 지정됩니다.

팁

• tsin의 시간 벡터가 달력 날짜에 대한 상대적인 값이 아니면 starttime과 endtime이 숫자형이어야 합니다.

• tsin의 시간 벡터가 달력 날짜에 대한 상대적인 값이면 starttime 값과 endtime 값이 날짜 문자형 벡터 또는 datenum 값이어야 합니다.

버전 내역

R2006a 이전에 개발됨

참고 항목

timeseries | tscollection