calyears

カレンダー期間の年数

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

構文

Y = calyears(X)

説明

calyears 関数は、カレンダー年数を表す配列を返します。カレンダーの計算で calendarDuration データ型の配列を使用すると、計算ではうるう年、夏時間のシフト、およびカレンダー月の長さの違いが考慮されます。代わりに正確な固定長の年数を作成するには、years 関数を使用します。固定長の 1 年の長さは 365.2425 日です。

Y = calyears(X) は、X の値に相当するカレンダー年数を表す配列を返します。

  • X が数値配列の場合、Y は calendarDuration 配列になります。この配列の各要素は、X の対応する要素のカレンダー年数に相当します。

  • X が calendarDuration 配列の場合、calyears は、X の各カレンダー期間に相当する整数の年数を返します。

例

例

すべて折りたたむ

ライブ スクリプトを開く
X = magic(4);
Y = calyears(X)
Y = 4×4 calendarDuration
   16y    2y    3y   13y
    5y   11y   10y    8y
    9y    7y    6y   12y
    4y   14y   15y    1y
ライブ スクリプトを開く

カレンダー期間の配列を作成します。その後、対応する整数のカレンダー年数に各値を変換します。

X = calmonths(21:25) + caldays(8)
X = 1×5 calendarDuration
    1y 9mo 8d   1y 10mo 8d   1y 11mo 8d        2y 8d    2y 1mo 8d


Y = calyears(X)
Y = 1×5

     1     1     1     2     2

入力引数

すべて折りたたむ

入力配列。数値配列、カレンダー期間配列、logical 配列のいずれかとして指定します。X が数値配列の場合、整数値しか格納できません。つまり、小数のカレンダー単位は作成できません。

出力引数

すべて折りたたむ

カレンダー年数。スカラー、ベクトル、行列または多次元配列として返されます。Y は X と同じサイズになります。Y のデータ型は X に基づきます。

  • X が数値配列の場合、Y は、カレンダー年数を可変長の単位で表すカレンダー期間の配列になります。

  • X が calendarDuration 配列の場合、Y は、カレンダー年数を整数で表す double 配列になります。

ヒント

  • カレンダー計算でうるう日が使用されている場合は、calyears による年数の作成時にもそれが考慮されます。正確な固定長 (365.2425 日) の年数を作成するには、関数 years を使用します。

拡張機能

すべて展開する

スレッドベースの環境
MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

バージョン履歴

R2014b で導入

参考

| |