MATLAB ヘルプ センター
入力の日付と時刻の年番号
y = year(t)
y = year(t,yearType)
y = year(t) は、入力配列内のそれぞれの日付と時刻について年番号を返します。既定では、year は ISO 年番号を返します。ISO 年番号には 0 年が含まれ、負の値を使用して紀元前の年を表します。
t
year
出力 y は double 配列です。ISO 年値を datetime 配列 t に代入するには、t.Year を使用して Year プロパティを変更します。
y
double
datetime
t.Year
Year
例
y = year(t,yearType) は、"iso" または "gregorian" のいずれかとして指定されたタイプの、datetime 配列 t の年番号を返します。
yearType
"iso"
"gregorian"
すべて折りたたむ
日付の配列から年番号を抽出します。
t = datetime(2010,05,31):calyears(1):datetime(2015,02,28)
t = 1×5 datetime 31-May-2010 31-May-2011 31-May-2012 31-May-2013 31-May-2014
y = 1×5 2010 2011 2012 2013 2014
入力の日付と時刻。datetime 配列として指定します。
Financial Toolbox™ を必要とする従来のコードをサポートできるように、year ではシリアル日付値やテキストを入力として使用することもできますが、この方法は推奨されません。詳細については、バージョン履歴を参照してください。
'iso'
'gregorian'
年の値のタイプ。'iso' または 'gregorian' のいずれかとして指定します。この引数は、t が datetime 配列の場合のみ有効です。
yearType が 'iso' の場合、year は ISO 年番号を返します。ISO 年番号には 0 年が含まれ、負の値を使用して紀元前の年を表します。
yearType が 'gregorian' の場合、year はグレゴリオ暦の年番号 (符号なし整数) を返します。たとえば、西暦 5 年と紀元前 5 年のグレゴリオ暦の年番号は両方とも 5 です。グレゴリオ暦の年番号に 0 年はありません。
この引数は、t が datetime 配列の場合のみ有効です。
すべて展開する
year 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。
backgroundPool
ThreadPool
year 関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。
year 関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。
year ではシリアル日付値とテキストの入力もサポートされていますが、推奨されるのは datetime 値です。datetime データ型を使用すると、柔軟な日付と時刻の形式、ナノ秒単位の精度のストレージ、タイム ゾーンと夏時間を考慮するためのプロパティを使用できます。
シリアル日付値またはテキストを datetime 値に変換するには、関数 datetime を使用します。以下に例を示します。
t = datetime(738427.656845093,"ConvertFrom","datenum"); y = year(t)
y = 2021
現在のところ、シリアル日付値やテキストの入力のサポートを削除する予定はありません。
以前のリリースでは、関数 year は 2 種類ありました。1 つは MATLAB® の関数で、datetime 値を使用していました。もう 1 つは Financial Toolbox の関数で、シリアル日付値やテキスト値を使用していました。R2022a 以降では、Financial Toolbox がなくても year™ を呼び出せます。year を MATLAB から呼び出す場合、従来のすべての入力型を使用できます。
Financial Toolbox
たとえば、MATLAB からシリアル日付値とテキストを使用して次の呼び出しを行うことができます。
y = year(738427.656845093)
y = year("28-Sep-2021")
さらに、year では 1 番目の入力が datetime 配列でない場合に、日付形式を指定する 2 番目の入力を使用できます。
y = year(t,F)
この構文では、関数 datestr について記載されている有効な日付形式を使用して F を指定します。ただし、'Q' 書式指定子はサポートされません。以下に例を示します。
datestr
F
'Q'
y = year("2021/28/09","yyyy/dd/mm")
ymd | quarter | month | week | day | datetime
ymd
quarter
month
week
day
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Web サイトの選択
Web サイトを選択すると、翻訳されたコンテンツにアクセスし、地域のイベントやサービスを確認できます。現在の位置情報に基づき、次のサイトの選択を推奨します:
また、以下のリストから Web サイトを選択することもできます。
最適なサイトパフォーマンスの取得方法
中国のサイト (中国語または英語) を選択することで、最適なサイトパフォーマンスが得られます。その他の国の MathWorks のサイトは、お客様の地域からのアクセスが最適化されていません。
南北アメリカ
ヨーロッパ
アジア太平洋地域
最寄りの営業オフィスへのお問い合わせ