Product UpdatesStatus PageWorkato Academy
English
日本語
Get a trial
Insights
リファレンス
計算列関数

日時関数 ​

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

次の日時関数を計算列で使用して、Insightsダッシュボード内の時間ベースの値を抽出、変更、計算できます。

エイリアス

関数はエイリアスを使用して検索できます。

たとえば、関数date_diffにエイリアスdatediffがある場合:

  • datediと入力すると、Insightsはdate_diff関数を提案します。
  • datediffと入力すると、Insightsはそれをdate_diffとして書き換えます。

NULLオペランド

Insightsでは、NULL値を含む式に対して次のロジックを使用します:

  • 式にNULL値が含まれている場合、計算列で返される結果もNULL値になります。

たとえば、icon開始日列のいずれかの行がNULLの場合、その行の計算列の結果もNULLになります:

= date_diff("day",icon開始日, current_date())

current_date ​

現在の日付を返します。

  • 戻り値の型: DATE
plaintext
current_date()

例 ​

この例では、プロジェクトの開始日からの経過時間を判定するために現在の日付を取得します:

= date_diff("day",icon開始日, current_date())

この関数を使用して、進行中のプロジェクトの期間を可視化できます。

current_time ​

現在のタイムスタンプを返します。

  • 戻り値の型: TIMESTAMP
  • エイリアス: now(), current_timestamp()
plaintext
current_time()

例 ​

この例では、アイテムがカート内に残っている時間を判定するために現在のタイムスタンプを取得します:

= date_diff("hour",iconカートのタイムスタンプ, current_time())

この関数を使用して、アイテムがショッピングカート内に残っている時間を可視化できます。

date_add ​

日付に日付または時刻の間隔を追加します。 タイムスタンプでも機能します。

  • 戻り値の型: DATE, TIMESTAMP
  • エイリアス: dateadd, timeadd, timestampadd
plaintext
date_add(interval_unit, interval_value, timestamp)

パラメーター ​

パラメータータイプ説明
interval_unitVARCHAR追加する量の単位。 使用できる値には"second"、"minute"、"hour"、"day"、"month"、"year"があります。
interval_valueBIGINT追加する時間の数量。 減算を実行するには負の値を使用します。
timestampDATE, TIMESTAMP追加先の日付またはタイムスタンプ。

例 ​

この例では、契約期間を開始日に追加して契約終了日を判定します:

= date_add("day", 45,icon契約開始日)

この関数を使用して、契約終了日を可視化できます。

月末日の処理

  • 対象月の日数が元の日付より少ない場合、結果は対象月の最終日になります。

    • たとえば、date_add("month", 1, "2024-01-31")は2024-02-29を返します。

  • 元の日付が月の最終日で、対象月の日数が多い場合、結果は対象月の最終日のままになります。

    • たとえば、date_add("month", 1, "2024-02-29")は2024-03-31を返します。

date_diff ​

指定した単位で表された2つのタイムスタンプ間の差を返します。

  • 戻り値の型: BIGINT
  • エイリアス: datediff, timediff, timestampdiff, date_subtract
plaintext
date_diff(interval_unit, start, end)

パラメーター ​

パラメータータイプ説明
interval_unitVARCHAR差分に使用する単位。 使用できる値には"second"、"minute"、"hour"、"day"、"month"、"year"があります。
startDATE, TIMESTAMP開始日または開始タイムスタンプ。
endDATE, TIMESTAMP終了日または終了タイムスタンプ。

例 ​

この例では、開始日と終了日の差を求めます:

= date_diff("day",icon開始日,icon終了日)

この関数を使用して、プロジェクトの期間を可視化できます。

date_trunc ​

タイムスタンプを指定した単位に切り捨てます。

  • 戻り値の型: DATE, TIMESTAMP
  • エイリアス: trunc
plaintext
date_trunc(interval_unit, timestamp)

パラメーター ​

パラメータータイプ説明
interval_unitVARCHAR保持する最小の日付部分。 使用できる値には"second"、"minute"、"hour"、"day"、"month"、"quarter"、"year"があります。
timestampDATE, TIMESTAMP切り捨てる日付またはタイムスタンプ。

例 ​

この例では、注文日を月レベルに切り捨てます:

= date_trunc("month",icon注文日)

この関数を使用して、年ごとの月間注文量を可視化できます。

date_part ​

タイムスタンプから指定した日付部分を抽出します。

  • 戻り値の型: BIGINT
  • エイリアス: extract
plaintext
date_part(interval_unit, timestamp)

パラメーター ​

パラメータータイプ説明
interval_unitVARCHAR抽出する日付部分。

使用できる値には"second"、"minute"、"hour"、"day"、"week"、"month"、"year"、"day_of_week"があります。

"week"を指定すると、日付のISO週番号（1～53）が返されます。 1年には52週または53週があります。 各週は月曜日に始まり、日曜日に終わります。

"day_of_week"を指定すると、月曜日=1、日曜日=7になります。
timestampDATE, TIMESTAMP抽出元の日付またはタイムスタンプ。

例 ​

この例では、トランザクションのタイムスタンプから年を抽出します:

= date_part("year",iconトランザクション日)

この関数を使用して、各年の総収益を計算できます。

day_of_week ​

値が1（月曜日）から7（日曜日）の範囲のISO曜日を返します。

  • 戻り値の型: BIGINT
  • エイリアス: dayofweek
plaintext
day_of_week(timestamp)

パラメーター ​

パラメータータイプ説明
timestampDATE, TIMESTAMP入力日付またはタイムスタンプ。

例 ​

この例では、注文が行われた曜日を特定します:

= day_of_week(icon注文タイムスタンプ)

この関数を使用して、注文量が最も多い曜日を特定できます。

name_of_day ​

タイムスタンプから曜日の3文字の名前を返します。

  • 戻り値の型: VARCHAR
  • エイリアス: dayname
plaintext
name_of_day(timestamp)

パラメーター ​

パラメータータイプ説明
timestampDATE, TIMESTAMP入力日付またはタイムスタンプ。

例 ​

この例では、注文が行われた曜日を特定します:

= name_of_day(icon注文タイムスタンプ)

この関数を使用して、注文量が最も多い曜日を特定できます。

name_of_month ​

タイムスタンプから月の3文字の名前を返します。

  • 戻り値の型: VARCHAR
  • エイリアス: monthname
plaintext
name_of_month(timestamp)

パラメーター ​

パラメータータイプ説明
timestampDATE, TIMESTAMP入力日付またはタイムスタンプ。

例 ​

この例では、注文が行われた月を特定します:

= name_of_month(icon注文タイムスタンプ)

この関数を使用して、注文量が最も多い月を特定できます。

hour ​

タイムスタンプから時間を抽出します。

  • 戻り値の型: BIGINT
plaintext
hour(timestamp)

パラメーター ​

パラメータータイプ説明
timestampTIMESTAMP入力タイムスタンプ。

例 ​

この例では、チャットのタイムスタンプから時間を抽出します:

= hour(iconセッションタイムスタンプ)

この関数を使用して、カスタマーサポートチャットのピーク時間を追跡できます。

day ​

タイムスタンプから月の日を抽出します。

  • 戻り値の型: BIGINT
  • エイリアス: dayofmonth, day_of_month
plaintext
day(timestamp)

パラメーター ​

パラメータータイプ説明
timestampDATE, TIMESTAMP入力日付またはタイムスタンプ。

例 ​

この例では、訪問日から日を抽出します:

= day(icon訪問日)

この関数を使用して、トラフィックが多い月内の日を特定できます。

week ​

タイムスタンプから年のISO週を抽出します。

  • 戻り値の型: BIGINT
plaintext
week(timestamp)

ISO週番号

日付のISO週番号の範囲は1～53です。 1年には52週または53週があります。 各週は月曜日に始まり、日曜日に終わります。

パラメーター ​

パラメータータイプ説明
timestampDATE, TIMESTAMP入力日付またはタイムスタンプ。

例 ​

この例では、タイムシートの送信から週を抽出します:

= week(icon勤務日)

この関数を使用して、週ごとの総労働時間を追跡できます。

month ​

タイムスタンプから月を抽出します。

  • 戻り値の型: BIGINT
plaintext
month(timestamp)

パラメーター ​

パラメータータイプ説明
timestampDATE, TIMESTAMP入力日付またはタイムスタンプ。

例 ​

この例では、トランザクションのタイムスタンプから月を抽出します:

= month(iconトランザクションタイムスタンプ)

この関数を使用して、各月の総収益を計算できます。

year ​

タイムスタンプから年を抽出します。

  • 戻り値の型: BIGINT
plaintext
year(timestamp)

パラメーター ​

パラメータータイプ説明
timestampDATE, TIMESTAMP入力日付またはタイムスタンプ。

例 ​

この例では、登録日の年を抽出します:

= year(icon登録日)

この関数を使用して、コースの学生数の年間成長を分析できます。

add_months ​

タイムスタンプに指定した月数を追加または減算します。

  • 戻り値の型: DATE, TIMESTAMP
plaintext
add_months(timestamp, num_months)

パラメーター ​

パラメータータイプ説明
timestampDATE, TIMESTAMP追加先の日付またはタイムスタンプ。
num_monthsINTEGER追加する月数。

例 ​

この例では、契約開始日の6か月後の日付を取得します:

= add_months(icon開始日, 6)

この関数を使用して、契約終了日を判定して可視化できます。

月末日の処理

  • 対象月の日数が元の日付より少ない場合、結果は対象月の最終日になります。

    • たとえば、add_month(1, "2024-01-31")は2024-02-29を返します。

  • 元の日付が月の最終日で、対象月の日数が多い場合、結果は対象月の最終日のままになります。

    • たとえば、add_month(1, "2024-02-29")は2024-03-31を返します。

Last updated: