quarter

入力の日付と時刻の四半期番号

構文

q = quarter(t)

説明

q = quarter(t) は、t で指定した日付と時刻のそれぞれについて四半期番号を返します。

出力 q は、1 ～ 4 の整数値が含まれる double 配列です。

例

日付に対応する四半期の値の特定

t = datetime(2013,05,31):calmonths(3):datetime(2014,05,31)

t = 1×5 datetime
   31-May-2013   31-Aug-2013   30-Nov-2013   28-Feb-2014   31-May-2014

q = quarter(t)

q = 1×5

     2     3     4     1     2

入力引数

t — 入力の日付と時刻

datetime 配列

入力の日付と時刻。datetime 配列として指定します。

Financial Toolbox™ を必要とする従来のコードをサポートできるように、quarter ではシリアル日付値やテキストを入力として使用することもできますが、この方法は推奨されません。詳細については、バージョン履歴を参照してください。

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

quarter 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

スレッドベースの環境

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

quarter 関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

quarter 関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2014b で導入

R2022a: シリアル日付値とテキストの入力は非推奨

quarter ではシリアル日付値とテキストの入力もサポートされていますが、推奨されるのは datetime 値です。datetime データ型を使用すると、柔軟な日付と時刻の形式、ナノ秒単位の精度のストレージ、タイム ゾーンと夏時間を考慮するためのプロパティを使用できます。

シリアル日付値またはテキストを datetime 値に変換するには、関数 datetime を使用します。以下に例を示します。

t = datetime(738427.656845093,"ConvertFrom","datenum");
q = quarter(t)

q =

     3

現在のところ、シリアル日付値やテキストの入力のサポートを削除する予定はありません。

R2022a: Financial Toolbox と MATLAB の関数 quarter を統合

以前のリリースでは、関数 quarter は 2 種類ありました。1 つは MATLAB^® の関数で、datetime 値を使用していました。もう 1 つは Financial Toolbox の関数で、シリアル日付値やテキスト値を使用していました。R2022a 以降では、Financial Toolbox がなくても quarter™ を呼び出せます。quarter を MATLAB から呼び出す場合、従来のすべての入力型を使用できます。

たとえば、MATLAB からシリアル日付値とテキストを使用して次の呼び出しを行うことができます。

q = quarter(738427.656845093)

q =

     3

q = quarter("28-Sep-2021")

q =

     3

非標準カレンダーおよび日付形式

さらに、quarter では、1 番目の入力が datetime 配列でない場合に、他の 2 つの入力を使用できます。使用している会計年度カレンダーの最初の月として 2 番目の入力 (month1) を指定できます。日付形式として 3 番目の入力 (F) を指定することもできます。

q = quarter(t,month1)
q = quarter(t,month1,F)

異なる会計年度カレンダーを基準として t の四半期を決定するには、(1 月から 12 月の各月に対応する) 1 から 12 の整数として month1 を指定します。たとえば、カレンダーの会計年度が 10 月 1 日に開始する場合は、month1 に 10 を指定します。

q = quarter("2021/28/09",10)

q =

     4

特定の日付形式を使用して t を解釈するには、関数 datestr について記載されている有効な日付形式を使用して F を指定します。ただし、'Q' 書式指定子はサポートされません。以下に例を示します。

q = quarter("2021/28/09",1,"yyyy/dd/mm")

q =

     3

参考

year | month | week | day