between
カレンダーの差分の計算
説明
例
2 つの datetime 配列の差分
2 つの datetime
配列を作成します。
t1 = datetime('now')
t1 = datetime
25-Jan-2024 22:18:44
t2 = datetime('tomorrow','Format','dd-MMM-yyyy HH:mm:ss') + caldays(0:2)
t2 = 1x3 datetime
26-Jan-2024 00:00:00 27-Jan-2024 00:00:00 28-Jan-2024 00:00:00
2 つの配列の差分を求めます。
dt = between(t1,t2)
dt = 1x3 calendarDuration
1h 41m 15.041s 1d 1h 41m 15.041s 2d 1h 41m 15.041s
between
は、差分を日、時間、分、秒で表した calendarDuration
配列を返します。
datetime 値の差分のカレンダー日数
6 か月間の datetime のシーケンスを作成します。その後、最初の日付からシーケンスの各日付までの日数を求めます。
t1 = datetime(2013,1,1); t2 = dateshift(t1,'end','month',0:4)
t2 = 1x5 datetime
31-Jan-2013 28-Feb-2013 31-Mar-2013 30-Apr-2013 31-May-2013
dt = between(t1,t2,'Days')
dt = 1x5 calendarDuration
30d 58d 89d 119d 150d
入力引数
t1
— 入力の日付と時刻
datetime
配列 | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列
入力の日付と時刻。datetime
配列、文字ベクトル、文字ベクトルの cell 配列、または string 配列として指定します。入力 t1
と t2
のうちのどちらかは datetime
配列でなければなりません。t1
と t2
は、いずれかがスカラー値でない限り、同じサイズでなければなりません。
t2
— 入力の日付と時刻
datetime
配列 | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列
入力の日付と時刻。datetime
配列、文字ベクトル、文字ベクトルの cell 配列、または string 配列として指定します。入力 t1
と t2
のうちのどちらかは datetime
配列でなければなりません。t1
と t2
は、いずれかがスカラー値でない限り、同じサイズでなければなりません。
components
— カレンダー成分または時刻の成分
'years'
| 'quarters'
| 'months'
| 'weeks'
| 'days'
| 'time'
| 文字ベクトルの cell 配列 | string 配列
カレンダー成分または時刻の成分。次の文字ベクトルの 1 つとして指定するか、これらの値を 1 つ以上含む cell 配列または string 配列として指定します。
'years'
'quarters'
'months'
'weeks'
'days'
'time'
'time'
を除き、これらの成分が表す時間の長さは一定ではありません。たとえば 1 か月の時間の長さは、1 月の datetime に追加する場合と 2 月の datetime に追加する場合とで異なります。
between
は、カレンダーまたは時刻の成分を大きいものから降順に処理します。
一般に、components
に 'time'
を含めない限り、t2
は t1 + dt
と等しくなりません。
例: {'years','quarters'}
データ型: char
| cell
| string
出力引数
dt
— 差分配列
calendarDuration
配列
差分配列。calendarDuration
配列として返されます。
ヒント
t1
とt2
の datetime 値の差分を正確な固定長の期間として計算するには、t2-t1
を使用します。
拡張機能
tall 配列
メモリの許容量を超えるような多数の行を含む配列を計算します。
この関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。
スレッドベースの環境
MATLAB® の backgroundPool
を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool
を使用してコードを高速化します。
この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。
分散配列
Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。
この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。
バージョン履歴
R2014b で導入
参考
minus
| diff
| caldiff
| calendarDuration
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)