ExcelWork.info

日付時刻:日付・時刻の間隔を取得( DateDiff 関数 )

DateDiff 関数の使い方


【書式】

result = DateDiff ( interval, date1, date2, [ firstdayofweek, firstweekofyear ] )


引数・戻り値

  • interval  ・・・  取得する日付間の間隔の「時刻・時間の単位」を表す文字列式を指定します(「時刻・時間単位の設定値表」を参照 )。
  • date1,date2  ・・・  比較する日付・時刻を指定します(内部処理形式 Date のバリアント型の値、もしくはリテラル文字列)。
  • firstdayofweek  ・・・  週の始まりの曜日を表す定数を指定します。省略すると日曜日を指定したものとみなされます(「週の始まりの曜日を示す定数」を参照 )。
  • firstweekofyear  ・・・  年度の第 1 週を表す定数を指定します。省略すると、1 月 1 日を含む週が第 1 週とみなされます(「年度の始まりを示す定数」を参照 )。
  • result  ・・・  2つの日付・時間( date1date2 )の間隔を表す数値(Long 型)。


時刻・時間単位の設定値表(interval に指定する値)

内容 備考
yyyy
q 四半期
m
y 年間通算日 d を指定した場合と同じ
d
w 週日 週間数( date1 の曜日から date2 までのその曜日の数。ただし date1 自体は数に含めない)。
ww 週間数( date1 から date2 までの日曜日の数。ただし date1 が日曜日の場合、date1 は数に含めない)。
h
n
s


週の始まりの曜日を示す定数(firstdayofweek に指定する値)

定数 内容
0 vbUseSystem NLS(システムの各国対応)APIの設定値を使用
1 vbSunday 日曜日(規定値)
2 vbMonday 月曜日
3 vbTuesday 火曜日
4 vbWednesday 水曜日
5 vbThursday 木曜日
6 vbFriday 金曜日
7 vbSaturday 土曜日


年度の始まりを示す定数(firstweekofyear に指定する値)

定数 内容
0 vbUseSystem NLS(システムの各国対応)APIの設定値を使用
1 vbFirstJan1 1月1日を含む週を年度の第1週とする(規定値)
2 vbFirstFourDays 7日のうち少なくとも4日が新年度に含まれる週を年度の第1週とする
3 vbFirstFullWeek 全体が新年度に含まれる最初の週を年度の第1週とする



DateDiff 関数の使用例

サンプルVBAソース


実行結果