timerange
timetable 行の添字の時間範囲
構文
説明
S = timerange(
は、timetable から時間範囲内の行を選択する添字を作成します。startTime,endTime
)S
は、startTime
と endTime
で指定された時間間隔内の時間をもつすべての行を選択します。これは startTime
を含みますが、endTime
を含みません。言い換えれば、時間間隔は半開区間です。startTime
と endTime
は datetime スカラーまたは duration スカラーであるか、日付と時刻を指定する文字ベクトルまたは string です。
startTime
と endTime
が datetime 値である場合、S
を使用して添字を指定できるのは、行時間が datetime 値である timetable に限られます。同様に、startTime
と endTime
が duration 値である場合、S
を使用して添字を指定できるのは、行時間が duration 値である timetable に限られます。
S = timerange(
は、startTime,endTime
,intervalType
)intervalType
で指定された間隔のタイプで添字を作成します。たとえば、intervalType
が 'closed'
の場合、S
が指定する時間範囲には startTime
と endTime
の両方が含まれます。
S = timerange(
は、startPeriod,endPeriod
,unitOfTime
)unitOfTime
で指定される日付や時刻のコンポーネントを使用して、startPeriod
から endPeriod
までの期間にわたり添字を作成します。たとえば、unitOfTime
が 'months'
の場合、S
には startPeriod
のコンポーネントである月の初頭と、endPeriod
の月の終わりが含まれます。入力 startPeriod
および endPeriod
は datetime スカラーとするか、あるいはテキストである場合なら、日付と時刻を指定する文字ベクトルまたは string とすることができます。
S = timerange(
は、timePeriod
,unitOfTime
)unitOfTime
で指定される日付または時刻のコンポーネントを使用して、timePeriod
の開始から終了までにわたる添字を作成します。たとえば、unitOfTime
が 'day'
の場合、S
には timePeriod
のコンポーネントである日の開始と終了が含まれます。
例
指定された時間間隔内にある timetable 行の選択
気温、気圧、風速、方向の測定値とともに時間を含む timetable を作成します。時間が指定された時間間隔内にある行を選択します。
Time = datetime({'12/18/2015 08:00:00';'12/18/2015 10:00:0';'12/18/2015 12:00:00';... '12/18/2015 14:00:00';'12/18/2015 16:00:00';'12/18/2015 18:00:00'}); Temp = [37.3;39.1;42.3;45.7;41.2;39.9]; Pressure = [30.1;30.03;29.9;29.8;30.0;29.9]; WindSpeed = [13.4;6.5;7.3;8.5;9.2;4.3]; WindDirection = categorical({'NW';'N';'NW';'NW';'NNW';'N'}); TT = timetable(Time,Temp,Pressure,WindSpeed,WindDirection)
TT=6×4 timetable
Time Temp Pressure WindSpeed WindDirection
____________________ ____ ________ _________ _____________
18-Dec-2015 08:00:00 37.3 30.1 13.4 NW
18-Dec-2015 10:00:00 39.1 30.03 6.5 N
18-Dec-2015 12:00:00 42.3 29.9 7.3 NW
18-Dec-2015 14:00:00 45.7 29.8 8.5 NW
18-Dec-2015 16:00:00 41.2 30 9.2 NNW
18-Dec-2015 18:00:00 39.9 29.9 4.3 N
12/18/2015 08:00:00
~ 12/18/2015 12:00:00
の時間範囲を指定します。
S = timerange('12/18/2015 08:00:00','12/18/2015 12:00:00')
S = timetable timerange subscript: Select timetable rows with times in the half-open interval: [18-Dec-2015 08:00:00, 18-Dec-2015 12:00:00) See Select Timetable Data by Row Time and Variable Type.
S
で指定される範囲内の時間をもつ行を選択します。出力 timetable には時間範囲の開始時間が含まれますが、終了時間は含まれません。
TT2 = TT(S,:)
TT2=2×4 timetable
Time Temp Pressure WindSpeed WindDirection
____________________ ____ ________ _________ _____________
18-Dec-2015 08:00:00 37.3 30.1 13.4 NW
18-Dec-2015 10:00:00 39.1 30.03 6.5 N
閉じた時間間隔内にある timetable 行の選択
timetable を作成します。
Time = [seconds(1):seconds(1):seconds(5)]; TT = timetable(Time',[98;97.5;97.9;98.1;97.9],[120;111;119;117;116],... 'VariableNames',{'Reading1','Reading2'})
TT=5×2 timetable
Time Reading1 Reading2
_____ ________ ________
1 sec 98 120
2 sec 97.5 111
3 sec 97.9 119
4 sec 98.1 117
5 sec 97.9 116
2 〜 4 秒の閉区間の時間間隔を指定します。
S = timerange(seconds(2),seconds(4),'closed')
S = timetable timerange subscript: Select timetable rows with times in the closed interval: [2 sec, 4 sec] See Select Timetable Data by Row Time and Variable Type.
S
で指定される範囲内の時間をもつ行を選択します。閉区間には開始時間と終了時間の両方が含まれます。
TT2 = TT(S,:)
TT2=3×2 timetable
Time Reading1 Reading2
_____ ________ ________
2 sec 97.5 111
3 sec 97.9 119
4 sec 98.1 117
期間の指定
各月半ばの物価を含む timetable を作成します。
Time = datetime(2018,1:12,15)'; Price = randi([85 110],12,1); TT = timetable(Time,Price)
TT=12×1 timetable
Time Price
___________ _____
15-Jan-2018 106
15-Feb-2018 108
15-Mar-2018 88
15-Apr-2018 108
15-May-2018 101
15-Jun-2018 87
15-Jul-2018 92
15-Aug-2018 99
15-Sep-2018 109
15-Oct-2018 110
15-Nov-2018 89
15-Dec-2018 110
'quarters'
を時間単位に使用して、時間範囲を指定します。時間範囲が開始されるのは、2018 年 1 月 1 日を含む四半期です。範囲が終了するのは、2018 年 5 月 1 日を含む四半期です。時間範囲には四半期全体が含められます。つまり、この範囲が終了するのは 2018 年 7 月 1 日の始まる直前です。
S = timerange('2018-01-01','2018-05-01','quarters')
S = timetable timerange subscript: Select timetable rows with times in: QUARTERS Starting at, including: 01-Jan-2018 00:00:00 Ending at, but excluding: 01-Jul-2018 00:00:00 See Select Timetable Data by Row Time and Variable Type.
TT
の行を選択します。出力 timetable には、2018 年の 5 月 15 日と 6 月 15 日の行が含められますが、7 月 15 日の行や、2018 年の最初の 2 四半期外の時間をもつ行は含められません。
TT(S,:)
ans=6×1 timetable
Time Price
___________ _____
15-Jan-2018 106
15-Feb-2018 108
15-Mar-2018 88
15-Apr-2018 108
15-May-2018 101
15-Jun-2018 87
1 つの日付から期間を指定
各月初頭と半ばの物価を含む timetable を作成します。
Time = datetime({'2018-01-01';'2018-01-15';'2018-02-01';'2018-02-15'; '2018-03-01';'2018-03-15'}); Price = randi([85 110],6,1); TT = timetable(Time,Price)
TT=6×1 timetable
Time Price
___________ _____
01-Jan-2018 106
15-Jan-2018 108
01-Feb-2018 88
15-Feb-2018 108
01-Mar-2018 101
15-Mar-2018 87
'months'
を時間単位に使用して、時間範囲を指定します。最初の入力が 2018 年 2 月の日付であるため、時間範囲は 2 月全体にわたることになります。
S = timerange('2018-02-01','months')
S = timetable timerange subscript: Select timetable rows with times in: MONTHS Starting at, including: 01-Feb-2018 00:00:00 Ending at, but excluding: 01-Mar-2018 00:00:00 See Select Timetable Data by Row Time and Variable Type.
TT
の行を選択します。
TT(S,:)
ans=2×1 timetable
Time Price
___________ _____
01-Feb-2018 88
15-Feb-2018 108
入力引数
startTime,endTime
— 時間範囲の開始時間と終了時間
datetime スカラーのペア | duration スカラーのペア | 文字ベクトルのペア | string スカラーのペア
時間範囲の開始時間と終了時間。datetime スカラーまたは duration スカラーのペア、あるいは文字ベクトルまたは string スカラーのペアとして指定します。
startTime
と endTime
が文字ベクトルまたは string スカラーの場合、これらは日付と時刻を指定します。startTime
と endTime
の形式が timerange
で認識されない場合は、関数 datetime
または duration
を使用して datetime または duration の値に変換します。datetime
または duration
の 'InputFormat'
引数を使用して形式を指定します。
片側のみ定められた時間範囲を作成するには、開始時間または終了時間に '-inf'
または 'inf'
を使用します。構文 timerange('-inf',endTime)
は、endTime
より前のすべての日付と時刻を指定します。また、timerange(startTime,'inf')
は startTime
後のすべての日付と時刻を指定します。
intervalType
— 時間範囲の区間のタイプ
文字ベクトル | string スカラー
時間範囲の区間のタイプ。文字ベクトルまたは string スカラーとして指定します。次の表に時間範囲の区間のタイプを示します。
区間のタイプ | 説明 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
startPeriod,endPeriod
— 開始と終了の期間
datetime スカラーのペア | 文字ベクトルのペア | string スカラーのペア
開始と終了の期間。datetime スカラーのペア、あるいは文字ベクトルまたは string スカラーのペアとして指定します。
startPeriod
と endPeriod
が文字ベクトルまたは string スカラーの場合、これらは日付と時刻を指定します。startPeriod
と endPeriod
の形式が timerange
で認識されない場合は、関数 datetime
を使用して datetime の値に変換します。datetime
の 'InputFormat'
引数を使用して形式を指定します。
片側のみ定められた時間範囲を作成するには、開始または終了の期間に '-inf'
または 'inf'
を使用します。たとえば、構文 timerange('-inf',endPeriod,'days')
は、endPeriod
の日の終了より前にすべての日付と時刻を指定します。構文 timerange(startTime,'inf','days')
は、startPeriod
の日の開始より後にすべての日付と時刻を指定します。
timePeriod
— 期間
datetime スカラー | 文字ベクトル | string スカラー
期間。datetime スカラー、文字ベクトル、または string スカラーとして指定します。timePeriod
が文字ベクトルまたは string スカラーである場合、関数 datetime
による datetime 値への変換が可能な日付と時刻が指定されます。
unitOfTime
— 期間のコンポーネント
文字ベクトル | string スカラー
期間のコンポーネント。文字ベクトルまたは string スカラーとして指定します。次の表は、指定可能なコンポーネントを示しています。
メモ: unitOfTime
は、入力引数で datetime の値を指定した場合にのみ指定でき、duration の値を指定した場合は指定できまません。
日付または時刻のコンポーネント | 説明 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
拡張機能
C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。
使用上の注意事項および制限事項:
入力引数
unitOfTime
はサポートされていません。
詳細については、timetable のコード生成 (MATLAB Coder)とコード生成における timetable の制限事項 (MATLAB Coder)を参照してください。
バージョン履歴
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)