addtodate

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

addtodate は推奨されません。時点を表すには datetime データ型を使用し、datetime 値に時間を追加するには duration 値または calendarDuration 値を使用します。コードの更新の詳細については、バージョン履歴またはシリアル日付値と日付文字列の推奨されないインスタンスの置き換えを参照してください。

構文

dt = addtodate(d,t,timeUnit)

説明

dt = addtodate(d,t,timeUnit) は、時間の長さ t をシリアル日付値 d に追加し、結果を別のシリアル日付値 dt として返します。入力引数 timeUnit は t の時間単位を指定します。たとえば、addtodate(d,12,"hours") は、d で表された日付と時刻に 12 時間を追加します。

例

シリアル日付値への時間の追加

2022 年 1 月 1 日を表すシリアル日付値を作成します。

d = datenum("2022-01-01")

d = 
738522

d に 14 日を追加します。表示用に、日付値を datetime 値に変換します。

dt = addtodate(d,14,"day")

dt = 
738536

datetime(dt,"ConvertFrom","datenum")

ans = datetime
   15-Jan-2022

2 番目の入力引数を負の数値として指定して、dt から 12 時間を減算します。

dt = addtodate(dt,-12,"hour")

dt = 
7.3854e+05

datetime(dt,"ConvertFrom","datenum")

ans = datetime
   14-Jan-2022 12:00:00

追加した時間の長さが十分に長い場合、dt は適切な期間に進むか戻ります。たとえば、dt に 30 日を追加すると、日付は 2 月にシフトします。

dt = addtodate(dt,30,"day");
datetime(dt,"ConvertFrom","datenum")

ans = datetime
   13-Feb-2022 12:00:00

入力引数

d — 入力の日付と時刻

シリアル日付値

入力の日付と時刻。シリアル日付値として指定します。

t — 時間の長さ

整数

d に追加する時間の長さ。–10¹⁶ 以上 10¹⁶ 以下の整数として指定します。

timeUnit — t の時間単位

"year" | "month" | "day" | "hour" | "minute" | "second" | "millisecond"

t の時間単位。リストされている値のいずれかとして指定します。

バージョン履歴

R2006a より前に導入

R2022b: 非推奨

addtodate を削除する予定はありません。ただし、代わりに datetime、duration、calendarDuration データ型が推奨されます。datetime データ型を使用すると、柔軟な日付と時刻の形式、ナノ秒単位の精度のストレージ、タイム ゾーンと夏時間を考慮するためのプロパティを使用できます。datetime 値に時間の長さを追加するには、duration 値 (時間数、分数、秒数を表す場合) または calendarDuration 値 (カレンダー年数、四半期数、月数、週数、日数を表す場合) を使用します。

たとえば、シリアル日付値を datetime 値に変換します。次に、関数 hours を使用して duration 値の配列を作成することで、4 時間ずつ増加する時間数の配列を追加します。その結果、datetime 値の配列が得られます。

d = 738522;
d = datetime(d,"ConvertFrom","datenum")

d = datetime
   01-Jan-2022

d = d + hours(0:4:12)

d = 1x4 datetime array
   01-Jan-2022 00:00:00   01-Jan-2022 04:00:00   01-Jan-2022 08:00:00   01-Jan-2022 12:00:00

関数 calmonths と関数 calweeks を使用して calendarDuration 値を作成することで、2022 年 1 月 1 日午後 12 時を表す datetime 値に 3 カレンダー月数と 2 カレンダー週数を追加します。その結果、2022 年 4 月 15 日午後 12 時を表す datetime 値が得られます。

d = datetime("01-Jan-2022 12:00:00");
d = d + calmonths(3) + calweeks(2)

d = datetime
   15-Apr-2022 12:00:00

参考

datetime | dateshift | datevec | duration | calendarDuration | eomday

トピック

• 日付と時刻のシーケンスの生成
• datetime 配列の日付と時刻の成分の抽出または割り当て
• 個別の変数からの日付と時刻の結合
• 日付と時刻の算術演算