years

年単位の期間

ページ内をすべて折りたたむ

構文

Y = years(X)

説明

Y = years(X) は、入力配列の値に相当する固定長の年数を含む配列を返します。

  • X が数値配列の場合、Y は固定長の年を単位とする duration 配列になります。固定長の 1 年は 365.2425 日と等しくなります。

  • X が duration 配列の場合、Y は double 配列になり、各要素は X の対応する要素の固定長の年数と等しくなります。

関数 years は、duration と double の間で値を変換します。期間を年単位で表示するには、その Format プロパティを 'y' に設定します。

うるう年には 1 日余分な日があります。カレンダー計算に使用する、うるう年を考慮したカレンダー年の配列を作成するには、関数 calyears を使用します。

例

例

すべて折りたたむ

ライブ スクリプトを開く
X = [1 3 5; 10 12 15]
X = 2×3

     1     3     5
    10    12    15


Y = years(X)
Y = 2×3 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 = 1×4 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

入力引数

すべて折りたたむ

入力配列。数値配列、duration 配列、logical 配列のいずれかとして指定します。

拡張機能

すべて展開する

バージョン履歴

R2014b で導入

参考