日付と時刻

DateAdd

指定された時間間隔を加算した日付を返します。

構文

DateAdd(interval, number, date)

引数

• interval：追加する時間間隔を設定する文字列です。利用可能な値は次のとおりです。
  • yyyy：年
  • q：四半期
  • m：月
  • y：年間通算日
  • d：日
  • w：平日
  • ww：週
  • h：時
  • n：分
  • s：秒
• number：追加する間隔の数を表します。正の値（将来の日付を取得する場合）または負の値（過去の日付を取得する）を指定できます。
• date：時間間隔を追加する日付を表します。

例：

次の式を使用して、現在の日付に1年を追加できます。

{DateAdd("yyyy", 1, Now())}

DateDiff

2つの指定した日付の時間間隔を返します。

構文

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

引数

• interval：date1とdate2の時間間隔の計算に使用する時間単位を設定する文字列です。利用可能な値は次のとおりです。
  • yyyy：年
  • q：四半期
  • m：月
  • y：年間通算日
  • d：日
  • w：平日
  • ww：週
  • h：時
  • n：分
  • s：秒
• date1、date2：計算の対象となる2つの日付を指定します。
• firstdayofweek：省略可能です。週の始まりの曜日（日曜日が1、土曜日が7）を表す数値です。省略すると、日曜日を指定したものと見なされます。
• firstweekofyear：省略可能です。年の第1週を指定する数値です。省略すると、1月1日を含む週が第1週と見なされます。利用可能な値は次のとおりです。
  • 1：1月1日が含まれる週から開始します。
  • 2：新年の少なくとも4日が含まれる最初の週から開始します。
  • 3：年の最初の完全な週から開始します。

例：

次の式を使用して、注文から出荷までにかかる時間を比較できます。

{DateDiff("d", ShipDate, OrderDate)}

DatePart

日付の指定した部分を返します。

構文

DatePart(interval, date, [ firstdayofweek, [ firstweekofyear ]])

引数

• interval：返す時間間隔を設定する文字列です。利用可能な値は次のとおりです。
  • yyyy：年
  • q：四半期
  • m：月
  • y：年間通算日
  • d：日
  • w：平日
  • ww：週
  • h：時
  • n：分
  • s：秒
• date：評価する日付です。
• firstdayofweek：省略可能です。週の始まりの曜日（日曜日が1、土曜日が7）を表す数値です。省略すると、日曜日を指定したものと見なされます。
• firstweekofyear：省略可能です。年の第1週を指定する数値です。省略すると、1月1日を含む週が第1週と見なされます。利用可能な値は次のとおりです。
  • 1：1月1日が含まれる週から開始します。
  • 2：新年の少なくとも4日が含まれる最初の週から開始します。
  • 3：年の最初の完全な週から開始します。

例：

次の式を使用して、現在の年とともに著作権マークを表示できます。

© {DatePart("yyyy", Now())}

DateSerial

指定した年、月、日に対応する日付を返します。

構文

DateSerial(year, month, day)

引数

• year：100～9999の範囲の整数を指定します。
• month：1～12の範囲の整数を指定します。
• day：1～31の範囲の整数を指定します。

例：

次の式を使用して、1982年1月4日を作成できます。

{DateSerial(1982, 1, 4)}

DateString

現在の日付をyyyy-mm-dd形式で表す文字列を返します。

構文

DateString()

DateValue

指定した文字列から日付を返します。

構文

DateValue(date)

引数

• date：yyyy-mm-dd形式の日付を含む文字列を指定します。

例：

次の式を使用して、2020-02-29の文字列から日付を作成できます。

{DateValue("2020-02-29")}

Day

月の日情報を表す1～31の範囲の数値を返します。

構文

Day(date)

引数

• date：評価する日付です。

例：

次の式を使用して、現在の日付から月の日を返すことができます。

{Day(Now())}

Hour

1日の時刻を表す0～23の範囲の数値を返します。

構文

Hour(date)

引数

• date：評価する日付です。

例：

次の式を使用して、現在の日付の時刻を返すことができます。

{Hour(Now())}

Minute

時刻の分を表す0～59の範囲の数値を返します。

構文

Minute(date)

引数

• date：評価する日付です。

例：

次の式を使用して、現在の日付の時刻の分を返すことができます。

{Minute(Now())}

Month

1年の何月かを表す1～12の範囲の数値を返します。

構文

Month(date)

引数

• date：評価する日付です。

例：

次の式を使用して、現在の日付の月を返すことができます。

{Month(Now())}

MonthName

指定した月を示す文字列を返します。

構文

MonthName(month, [ abbreviate ])

引数

• month：月を指定する数値です。 たとえば、1月は「1」、2月は「2」などです。
• abbreviate：省略可能です。月の名前を省略形にするかどうかを指定するブール値です。既定値はFalseです。

例：

次の式を使用して、現在の月の省略形を返すことができます。

{MonthName(Month(Now()), true)}

Now

現在の日付と時刻を返します。

構文

Now()

Second

分の秒を表す0～59の範囲の数値を返します。

構文

Second(date)

引数

• date：評価する日付です。

例：

現在の日付の分の秒を返すには、次の式を使用できます。

{Second(Now())}

TimeOfDay

現在の時刻を含む日付を返します。

構文

TimeOfDay()

Timer

午前0時（真夜中）から経過した秒数を表す数値を返します。

構文

Timer()

TimeSerial

指定した時間、分、秒に対応する時刻を含む日付を返します。

構文

TimeSerial(hour, minute, second)

引数

• hour：0～23の範囲の整数を指定します。
• minute：0～59の範囲の整数を指定します。
• second：0～59の範囲の整数を指定します。

例：

次の式を使用して、午後3時30分で日付を作成できます。

{TimeSerial(15, 30,0)}

TimeString

現在の時刻を表す文字列を返します。

構文

TimeString()

TimeValue

指定した文字列から時刻値を返します。

構文

TimeValue(time)

引数

• time：12時間制または24時間制の時刻値を含む文字列です。

例：

次の式を使用して、午前3時15分の文字列から時刻を作成できます。

{TimeValue("3:15am")}

Today

現在の日付（真夜中）を返します。

構文

Today()

Weekday

曜日を表す数値を返します。

構文

Weekday(date, [ firstdayofweek ])

引数

• date：評価する日付です。
• firstdayofweek：省略可能です。週の始まりの曜日（日曜日が1、土曜日が7）を表す数値です。省略すると、日曜日を指定したものと見なされます。

例：

次の式を使用して、現在の曜日を返すことができます。

{Weekday(Today())}

WeekDayName

指定した曜日を示す文字列を返します。

構文

WeekdayName(weekday, [abbreviate, [firstdayofweek ]])

引数

• weekday：曜日を指定する数値です。 各曜日の数値は、firstdayofweek の設定によって決まります。
• abbreviate：省略可能です。曜日の名前を省略形にするかどうかを指定するブール値です。既定値はFalseです。
• firstdayofweek：省略可能です。週の始まりの曜日（日曜日が1、土曜日が7）を表す数値です。省略すると、日曜日を指定したものと見なされます。

例：

次の式を使用して、現在の曜日の省略形を返すことができます。

{WeekDayName(Weekday(Now()), true)}

Quarter

1年の四半期を表す1～4の範囲の数値を返します。

構文

Quarter(date)

引数

• date：評価する日付です。

例：

次の式を使用して、現在の日付の年の四半期を返すことができます。

{Quarter(Now())}

QuarterName

四半期名を表す文字列を返します。

構文

QuarterName(date)

引数

• date：評価する日付です。

例：

次の式を使用して、現在の日付の四半期名を返すことができます。

{QuarterName(Now())}

Year

年を表す数値を返します。

構文

Year(date)

引数

• date：評価する日付です。

例：

現在の年を返すには、次の式を使用できます。

{Year(Now())}

AddYears

特定の日付に指定した年数を追加した新しい日付を返します。

構文

<Date>.AddYears(years)

引数

• years：追加する年数です。正または負の数値を指定できます。

例：

次の式を使用して、現在の日付より2年後の日付を返すことができます。

{Now().AddYears(2)}

AddMonths

特定の日付に指定した月数を追加した新しい日付を返します。

構文

<Date>.AddMonths(months)

引数

• months：追加する月数です。正または負の数値を指定できます。

例：

次の式を使用して、現在の日付から5か月前の日付を返すことができます。

{Now().AddMonths(-5)}

AddDays

特定の日付に指定した日数を追加した新しい日付を返します。

構文

<Date>.AddMonths(days)

引数

• days：追加する日数です。正または負の数値を指定できます。

例：

次の式を使用して、明日の日付を返すことができます。

{Now().AddDays(1)}

AddHours

特定の日付に指定した時間数を追加した新しい日付を返します。

構文

<Date>.AddHours(hours)

引数

• hours：追加する時間数です。正または負の数値を指定できます。

例：

次の式を使用して、昨日の日付を返すことができます。

{Now().AddHours(-24)}

AddMinutes

特定の日付に指定した分数を追加した新しい日付を返します。

構文

<Date>.AddMinutes(minutes)

引数

• minutes：追加する分数です。正または負の数値を指定できます。

例：

次の式を使用して、現在の日付より30分遅れた日付を返すことができます。

{Now().AddMinutes(-30)}

AddSeconds

特定の日付に指定した秒数を追加した新しい日付を返します。

構文

<Date>.AddSeconds(seconds)

引数

• seconds：追加する秒数です。正または負の数値を指定できます。

例：

次の式を使用して、現在の日付より45秒後の日付を返すことができます。

{Now().AddSeconds(45)}

AddMilliseconds

特定の日付に指定したミリ秒数を追加した新しい日付を返します。

構文

<Date>.AddMilliseconds(milliseconds)

引数

• milliseconds：追加するミリ秒数です。正または負の数値を指定できます。

例：

次の式を使用して、現在の日付より654ミリ秒遅れた日付を返すことができます。

{Now().AddMilliseconds(-654)}