datetime 配列の日付と時刻の成分の抽出または割り当て

次の例では、既存の datetime 配列から日付と時刻の成分を抽出する方法として、配列のプロパティへのアクセスと関数呼び出しの 2 つの方法を示します。次に、配列のプロパティを変更して、日付と時刻の成分を変更する方法を示します。

datetime 配列を作成します。

t = datetime('now') + calyears(0:2) + calmonths(0:2) + hours(20:20:60)

t = 1x3 datetime
   20-Feb-2023 11:38:30   21-Mar-2024 07:38:30   22-Apr-2025 03:38:30

配列内の各 datetime の年の値を取得します。ドット表記を使用して t の Year プロパティにアクセスします。

t_years = t.Year

t_years = 1×3

        2023        2024        2025

出力の t_years は数値配列です。

Month プロパティにアクセスして、t の各 datetime の月の値を取得します。

t_months = t.Month

t_months = 1×3

     2     3     4

t の Hour、Minute および Second プロパティにアクセスすることで、各 datetime の日付、時、分、秒のコンポーネントをそれぞれ取得できます。

関数 month を使用して、t 内の各 datetime の月番号を取得します。関数の使用は、t の特定の日付や時刻のコンポーネントを取得するための代替方法です。

m = month(t)

m = 1×3

     2     3     4

Month プロパティではなく、関数 month を使用して t の各 datetime の完全な月名を取得します。

m = month(t,'name')

m = 1x3 cell
    {'February'}    {'March'}    {'April'}

t の各 datetime の年、四半期、週、日、時、分および秒の各コンポーネントは、それぞれ関数 year、quarter、week、hour、minute および second を使用して取得できます。

t の各 datetime について、通年の週番号を取得します。

w = week(t)

w = 1×3

     8    12    17

関数 ymd を使用して、t の年、月および日の値を 3 つの独立した数値配列として取得します。

[y,m,d] = ymd(t)

y = 1×3

        2023        2024        2025

m = 1×3

     2     3     4

d = 1×3

    20    21    22

関数 hms を使用して、t の時、分および秒の値を 3 つの独立した数値配列として取得します。

[h,m,s] = hms(t)

h = 1×3

    11     7     3

m = 1×3

    38    38    38

s = 1×3

   30.7871   30.7871   30.7871

配列のプロパティを変更して、既存の datetime 配列のコンポーネントに新しい値を割り当てます。ドット表記を使用して特定のプロパティにアクセスします。

t のすべての datetime 値の年番号を 2014 に変更します。ドット表記を使用して Year プロパティを変更します。

t.Year = 2014

t = 1x3 datetime
   20-Feb-2014 11:38:30   21-Mar-2014 07:38:30   22-Apr-2014 03:38:30

t の 3 つの datetime 値の月を、それぞれ 1 月、2 月および 3 月に変更します。新しい値は数値配列として指定しなければなりません。

t.Month = [1,2,3]

t = 1x3 datetime
   20-Jan-2014 11:38:30   21-Feb-2014 07:38:30   22-Mar-2014 03:38:30

TimeZone プロパティに値を代入して、t のタイムゾーンを設定します。

t.TimeZone = 'Europe/Berlin';

t の表示形式を変更して、日付のみを表示し時間情報を表示しないようにします。

t.Format = 'dd-MMM-yyyy'

t = 1x3 datetime
   20-Jan-2014   21-Feb-2014   22-Mar-2014

通常の範囲外の値を datetime 成分に割り当てると、MATLAB® はコンポーネントを正規化します。月間通算日番号の通常の範囲は 1 から 31 です。この範囲を超える日の値を割り当てます。

t.Day = [-1 1 32]

t = 1x3 datetime
   30-Dec-2013   01-Feb-2014   01-Apr-2014

月番号と年番号は、各 date コンポーネントが通常の範囲内にあるように調整されます。この場合、2014 年 1 月 ‐1 日は 2013 年 12 月 30 日に変換されます。

参考