day

入力の日付と時刻の日番号と日名

ページ内をすべて折りたたむ

構文

d = day(t)
d = day(t,dayType)

説明

d = day(t) は、入力配列内のそれぞれの日付と時刻について日を返します。既定では、day は、入力 datetime 配列 t の要素の月間通算日番号を返します。

出力 d は 1 から 31 までの整数値が格納された double 配列です。値の範囲は月および年によって異なります。日の値を datetime 配列 t に代入するには、t.Day を使用して Day プロパティを変更します。

例

d = day(t,dayType) は、datetime 配列 t の日番号または日名を、指定した型 ("dayofmonth"、"dayofweek"、"dayofyear"、"name"、"shortname" のいずれか) で返します。

例

例

すべて折りたたむ

ライブ スクリプトを開く

日付の配列から月間通算日番号を抽出します。

t = [datetime('yesterday');datetime('today');datetime('tomorrow')]
t = 3×1 datetime
   08-Aug-2025
   09-Aug-2025
   10-Aug-2025


d = day(t)
d = 3×1

     8
     9
    10
ライブ スクリプトを開く

関数 day の 2 番目の入力として 'name' を指定して、任意の日付の曜日を判別します。

t = datetime(2014,05,16)
t = datetime
   16-May-2014


d = day(t,'name')
d = 1×1 cell array
    {'Friday'}

あるいは、'dayofweek' を指定して曜日の番号を返します。

d = day(t,'dayofweek')
d = 
6

入力引数

すべて折りたたむ

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

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

日の値のタイプ。次の表の値として指定します。

dayType の値

説明

'dayofmonth' (既定)

1 から 28、29、30、31 までの月間通算日番号。範囲は月によって異なります。

'dayofweek'

1 から 7 までの曜日の値。1 が日曜日です。

'iso-dayofweek' (R2023a 以降)

ISO 8601 標準に従った、1 から 7 までの曜日番号。1 が月曜日です。

'dayofyear'

1 から 365 または 366 までの年間通算日番号。範囲は年によって異なります。

'name'

曜日の完全名。たとえば Sunday です。NaT の datetime 値では、曜日名は空の文字ベクトル '' です。

'shortname'

曜日の短縮名。たとえば Sun です。NaT の datetime 値では、曜日名は空の文字ベクトル '' です。

メモ

day は、[設定] ウィンドウの [日付と時刻の形式] セクションの [ロケール] オプションに指定された言語で曜日名を返します。既定の日付と時刻のロケールを変更する方法については、Modify Command Window Settingsを参照してください。

この引数は、t が datetime 配列の場合のみ有効です。

出力引数

すべて折りたたむ

日番号または曜日名。double 型の整数の数値配列または文字ベクトルの cell 配列として返されます。d のサイズは t と同じです。

拡張機能

すべて展開する

バージョン履歴

R2014b で導入

すべて展開する

参考

| | | | | |