日付と時刻

異なる形式で表示できる日付と時刻の値の配列

日付と時刻のデータ型 datetime、duration および calendarDuration は、日付と時刻の効率的な計算、比較、書式設定された表示をサポートします。これらの配列は数値配列と同じ方法で使用します。日付と時刻の値を加算、減算、並べ替え、比較、連結、およびプロットできます。日付および時刻を数値配列またはテキストとして表すこともできます。詳細については、MATLAB での日付と時刻の表現を参照するか、日付と時刻の配列をご覧ください。

関数

すべて展開する

日付と時刻の配列の作成

時点

`datetime`	時点を表す配列
`dateshift`	日付のシフトと日付および時刻のシーケンスの生成
`NaT`	Not-a-Time
`eomday`	月の最終日
`lweekdate`	(Not recommended; use `dateshift`) Date of last occurrence of weekday in month
`nweekdate`	(Not recommended; use `dateshift`) Date of specific occurrence of weekday in month

期間

`years`	年単位の期間
`days`	期間の日数
`hours`	期間 (時間数)
`minutes`	分単位の期間
`seconds`	期間の秒数
`milliseconds`	ミリ秒単位の期間
`duration`	固定長の単位で表す時間の長さ

カレンダー期間

`calyears`	カレンダー期間の年数
`calquarters`	カレンダー期間の四半期数
`calmonths`	カレンダー期間の月数
`calweeks`	カレンダー期間の週数
`caldays`	カレンダー期間の日数
`calendarDuration`	可変長カレンダー単位の時間の長さ

月のカレンダー

calendar 指定した月のカレンダー

代替形式での時点

`datenum`	(非推奨、`datetime` または `duration` を使用すること) 日付と時刻をシリアル日付値に変換
`now`	(非推奨、`datetime` を使用すること) シリアル日付値として表現された現在の日時
`clock`	(非推奨、`datetime` を使用すること) 日付ベクトルとして表現された現在の日付
`date`	(非推奨、`datetime("today")` を使用すること) 文字ベクトルとしての現在の日付
`today`	(非推奨、`datetime("today")` を使用すること) 現在の日付
`eomdate`	(Not recommended; use `dateshift`) Last date of month

日付と時刻の成分

成分の抽出

`year`	入力の日付と時刻の年番号
`quarter`	入力の日付と時刻の四半期番号
`month`	入力の日付と時刻の月番号と月名
`week`	入力の日付と時刻の週番号
`day`	入力の日付と時刻の日番号と日名
`weekday`	曜日
`hour`	入力の日付と時刻の時間コンポーネント
`minute`	入力の日付と時刻の分コンポーネント
`second`	入力の日付と時刻の秒コンポーネント
`weeknum`	(Not recommended; use `week`) Week in year

成分への分割

`ymd`	datetime の年、月、日の番号
`hms`	datetime または duration の時間、分、秒数
`datevec`	日付と時刻を成分のベクトルに変換
`split`	カレンダー期間を数値と期間の単位に分割
`time`	カレンダー期間の時間を期間に変換
`timeofday`	`datetime` 配列の深夜からの経過時間

差分の計算または日付のシフト

`datetime` 配列

`between`	カレンダーの差分の計算
`caldiff`	カレンダーの連続する差分の計算
`tzoffset`	UTC からのタイムゾーンオフセット
`dateshift`	日付のシフトと日付および時刻のシーケンスの生成

固定書式配列

`addtodate`	(非推奨、`duration` または `calendarDuration` を使用すること) 日付と時刻を文字列形式に変換
`etime`	(非推奨、`datetime` 値または `between` を使用すること) 日付ベクトル間の経過時間
`months`	(Not recommended; use `between`) Number of whole months between dates

配列の内容のクエリ

`isbetween`	日付と時刻の区間内の要素を判別
`isregular`	時間またはカレンダーの単位に関して入力時間が規則的かどうかを判別
`isnat`	NaT (Not-a-Time) 要素の判別
`isdst`	夏時間要素の判別
`isweekend`	週末の要素の判別
`isdatetime`	入力が datetime 配列かどうかを判別
`isduration`	入力が duration 配列かどうかを判別
`iscalendarduration`	入力がカレンダー期間配列かどうかを判別

テキストへの変換

`string`	string 配列
`char`	文字配列
`datestr`	(非推奨、`string` または `char` を使用すること) 日付と時刻を文字列形式に変換

Excel、POSIX、およびその他の日付と時刻のシステム

変換

`convertTo`	`datetime` 値を数値表現に変換
`exceltime`	MATLAB datetime の Excel 日付値への変換
`posixtime`	MATLAB datetime の POSIX 時間への変換
`juliandate`	MATLAB の datetime をユリウス日に変換
`yyyymmdd`	MATLAB datetime の YYYYMMDD 数値への変換
`m2xdate`	(Not recommended; use `exceltime`) MATLAB date to Excel serial date number
`x2mdate`	(非推奨、`datetime` を使用すること) Excel のシリアル日付値を MATLAB のシリアル日付値または `datetime` 値に

MATLAB の時間

`timezones`	タイムゾーンの一覧
`leapseconds`	`datetime` データ型によってサポートされるすべてのうるう秒のリストを表示 (R2020a 以降)

下位互換性

matlab.datetime.compatibility.convertDatenum Convert inputs to datetime values in a backward-compatible way (R2022a 以降)

トピック

MATLAB での日付と時刻の表現

配列 datetime を使用して、日付と時刻の情報を格納します。これらの配列は、演算、並べ替え、比較、プロットおよび書式設定された表示をサポートします。
シリアル日付値と日付文字列の推奨されないインスタンスの置き換え
R2022b 以降、日付と時刻を指定する際にシリアル日付値と日付文字列は推奨されません。代わりに、datetime、duration、および calendarDuration データ型を使用します。コード更新に関する以下の推奨事項に従います。
関係演算子を使用した日付と時刻の比較

>、<、== などの関係演算子を使用して、2 つの datetime 配列または 2 つの duration 配列の要素ごとの日付と時刻の比較を実行できます。比較ではタイムゾーンや夏時間などのその他の情報も考慮できます。
- 日付と時刻の算術演算
- 日付と時刻のプロット
日付と時刻の表示形式の設定
配列 datetime、duration および calendarDuration の Format プロパティは、各配列の値の表示を制御します。このプロパティの値は変更できます。Format プロパティを変更しても、表示が変更されるだけで配列内の値は変更されません。
タイムゾーンの指定

datetime を作成すると、既定ではタイムゾーンは設定されません。複数のタイムゾーンからの datetime 値を扱う場合や、夏時間を考慮する必要がある場合は、タイムゾーンを指定する必要があります。
- 日付と時刻のユリウス日または POSIX 時間への変換
ロケール間でのコードとデータの共有
日付と時刻を処理するコードを他のロケールの MATLAB^® ユーザーと共有する場合、これらのベストプラクティスに従います。他のロケールから日付の書き込みと読み取りを行います。
日付と時刻の配列をサポートする主要な関数
MATLAB には、日付と時刻の配列を他の配列とほぼ同じ方法で操作できる関数が多数あります。