years
年単位の期間
説明
Y = years(
は、X
)X
の値に相当する年の配列を返します。
X
が数値配列の場合、Y
は固定長の年を単位とするduration
配列になります。固定長の 1 年は 365.2425 日と等しくなります。X
がduration
配列の場合、Y
はdouble
配列になり、各要素はX
の対応する要素の固定長の年数と等しくなります。
関数 years
は、duration
と double
の間で値を変換します。期間を年単位で表示するには、その Format
プロパティを 'y'
に設定します。
うるう年には 1 日余分な日があります。カレンダー計算に使用する、うるう年を考慮したカレンダー年の配列を作成するには、関数 calyears
を使用します。
例
固定長の年の duration 配列の作成
X = [1 3 5; 10 12 15]
X = 2×3
1 3 5
10 12 15
Y = years(X)
Y = 2x3 duration
1 yr 3 yrs 5 yrs
10 yrs 12 yrs 15 yrs
期間を年の数値配列に変換
2 つの日付の配列間の差を調べます。出力は duration
配列です。
t1 = datetime(2007:2010,10,1); t2 = datetime(2014,05,1); dt = t2 - t1
dt = 1x4 duration
57696:00:00 48912:00:00 40152:00:00 31392:00:00
dt
の各期間を固定長の年数に変換します。
Y = years(dt)
Y = 1×4
6.5819 5.5799 4.5805 3.5812
入力引数
X
— 入力配列
数値配列 | duration 配列 | logical 配列
入力配列。数値配列、duration 配列、logical 配列のいずれかとして指定します。
拡張機能
tall 配列
メモリの許容量を超えるような多数の行を含む配列を計算します。
この関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。
C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。
この関数はコード生成を完全にサポートしています。詳細については、duration 配列のコードの生成 (MATLAB Coder)を参照してください。
スレッドベースの環境
MATLAB® の backgroundPool
を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool
を使用してコードを高速化します。
この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。
分散配列
Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。
この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。
バージョン履歴
R2014b で導入
参考
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)