日付および時刻関数

TimeSpan を追加する場合は、DateTime カラムと TimeSpan カラムの 2 つの引数が必要です。

整数値を日付部分または時刻部分に追加する場合は、以下の 3 つの引数が使用されます。Arg1 は、追加する部分を表す文字列です。Arg2 は、追加する部分の数を含む数値です。Arg3 は、Date、Time または DateTime のカラムです。

Arg1 の有効な引数は以下のとおりです。

'year' または 'yy' - 年。

'quarter' または 'qq' - 四半期。

'month' または 'mm' - 月。

'day' または 'dd' - 日。

'week' または 'wk' - 週。

'hour' または 'hh' - 時間。

'minute' または 'mi' - 分。

'second' または 'ss' - 秒。

'millisecond' または 'ms' - ミリ秒。

例:

DateAdd([Date Column], [TimeSpan Column])

DateAdd('year', 2, [Date Column])

DateAdd('month', 1, [Date Column])

2 つの引数 (開始日付カラムと終了日付カラム) が使用されている場合、結果として TimeSpan の値が表示され、全差異が示されます。

3 つの引数が使用されている場合、1 つ目の引数が比較対象部分となる必要があります。2 つ目の引数は開始日付カラムであり、3 つ目の引数は終了日付カラムです。演算結果は実数値で示されます。

Arg1 の有効な引数は以下のとおりです。

'year' または 'yy' - 年。

'quarter' または 'qq' - 四半期。

'month' または 'mm' - 月。

'day' または 'dd' - 日。

'week' または 'wk' - 週。

'hour' または 'hh' - 時間。

'minute' または 'mi' - 分。

'second' または 'ss' - 秒。

'millisecond' または 'ms' - ミリ秒。

例:

DateDiff([Order Date], [Delivery Date])

DateDiff('day', [Order Date], [Delivery Date])

例については、「時刻の差異の計算」および「期間を計算する」を参照してください。

Arg1 の有効な引数は以下のとおりです。

'year' または 'yy' - 年。

'quarter' または 'qq' - 四半期。

'month' または 'mm' - 月。

'day of year' または 'dy' - 年月日。

'day' または 'dd' - 日。

'year and week' または 'yywk' - 年と週。

'week' または 'wk' - 週。

'day of week' または 'dw' - 平日。

'hour' または 'hh' - 時間。

'minute' または 'mi' - 分。

'second' または 'ss' - 秒。

'millisecond' または 'ms' - ミリ秒。

例:

DatePart('year', [Date Column])

例:

DateTimeNow()

例については、「時刻の差異の計算」および「期間を計算する」を参照してください。

例:

Day([Date Column])

例:

DayOfMonth([Date Column])

例:

DayOfWeek([Date Column])

例:

DayOfYear([Date Column])

または、引数が Integer 値の場合は、入力が日数の TimeSpan カラムを作成します。

例:

Days([TimeSpan Column])

Days(3)

最初の引数は Date カラムです。2 つ目の引数 (オプション) は、移動する月数です。

2 つ目の引数を指定しない場合、文書プロパティ FiscalYearOffset の値が使用されます。地域の設定に基づいて書式設定された出力が決定されます。

階層で使用されている場合、FiscalMonth メソッドは、ビジュアライゼーション項目が正しい順で表示されるよう月の並び順を追跡します。たとえば、会計年度が 1 月で終わる場合、次の会計年度は、次に示すように 1 月からではなく 2 月から始まる必要があります。

画像の階層は、次の式を使用して構築されています。

<FiscalYear([Date Column],1) NEST FiscalMonth([Date Column],1)>

例:

FiscalMonth([Date Column], 1)

FiscalMonth([Date Column])

2 つ目の引数はオプションです。2 つ目の引数を指定しない場合、文書プロパティ FiscalYearOffset の値が使用されます。

例:

FiscalQuarter([Date Column], 1)

FiscalQuarter([Date Column])

2 つ目の引数はオプションです。2 つ目の引数を指定しない場合、文書プロパティ FiscalYearOffset の値が使用されます。

例:

FiscalYear([Date Column], 1)

FiscalYear([Date Column])

例:

Hour([Time Column])

TimeSpan の時間数を 0 から 23 までの Integer 値として返します。

または、引数が Integer 値の場合は、入力が時間数の TimeSpan カラムを作成します。

例:

Hours([TimeSpan Column])

Hours(10)

DateTime または Time のカラムからミリ秒を抽出します。結果は、0 ～ 999 の間の整数です。

例:

Millisecond([Time Column])

TimeSpan のミリ秒数を 0.0 から 999.0 までの Real 値として返します。

または、引数が Real 値の場合は、入力がミリ秒数の TimeSpan カラムを作成します。

例:

Milliseconds([TimeSpan Column])

Milliseconds(123.45)

例:

Minute([Time Column])

TimeSpan の分数を 0 から 59 までの Integer 値として返します。

または、引数が Integer 値の場合は、入力が分数の TimeSpan カラムを作成します。

例:

Minutes([TimeSpan Column])

Minutes(50)

例:

Month([Date Column])

例:

Quarter([Date Column])

例:

Second([Time Column])

または、引数が Integer 値の場合は、入力が秒数の TimeSpan カラムを作成します。

例:

Seconds([TimeSpan Column])

Seconds(10)

例:

Today()

例:

TotalDays([TimeSpan Column])

例:

TotalHours([TimeSpan Column])

例:

TotalMilliseconds([TimeSpan Column])

例:

TotalMinutes([TimeSpan Column])

例:

TotalSeconds([TimeSpan Column])

例:

Week([Date Column])

例:

Year([Date Column])

例:

YearAndWeek([Date Column])