すべてのプロダクト
Search

このプロダクト

    Quick BI:日付関数

    ドキュメントセンター

    Quick BI:日付関数

    最終更新日:Feb 10, 2026

    日付関数は、データ分析において日付と時刻を処理します。これらは日付のフォーマット、日付間の差分の計算、現在のタイムスタンプの返却、時間単位の追加または減算を行います。このトピックでは、組み込みの日付関数の使用方法について説明します。

    BI_DATEADD

    BI_DATEADD は、指定された時間間隔を追加した後の日付を返します。

    構文

    BI_DATEADD(date, interval, date_part)

    パラメータ

    • date: 返される日付。

    • interval: 時間間隔を指定します。

    • date_part: 時間単位。サポートされている値 (大文字と小文字を区別しない) は次のとおりです。

      year: 年

      quarter: 四半期

      月

      週

      日

      hour: 時

      Minute: 分

      second: 秒

    定義

    指定された <interval> を日付の <date_part> に追加して計算された新しい日付を返します。

    出力

    日付

    例

    BI_DATEADD('2020-09-29', 100, 'day') = 2021-01-07

    制限事項

    Lindorm (LindormTSDB) データソースではサポートされていません。

    Lindorm (LindormTable, マルチモデル SQL) データソース バージョン 2.8 以降でのみサポートされています。

    BI_DATEDIFF

    BI_DATEDIFF は、2つの日付間の差分を返します。

    構文

    BI_DATEDIFF(date1, date2, date_part)

    パラメータ

    • date1: 最初の入力日付。

    • date2: 2番目の入力日付。

    • date_part: 結果の時間単位。サポートされている値 (大文字と小文字を区別しない) は次のとおりです。

      year: 年

      Quarter: 四半期

      month: 月

      週

      日

      Hour: 時

      minute: 分

      second: 秒

    定義

    <date1> と <date2> の差分を、完全な <date_part> 単位で表現して返します。

    出力

    整数

    例

    BI_DATEDIFF('2024-05-22', '2020-09-29', 'year') = 3

    これは、2020年9月29日から2024年5月22日までの間に3年間の完全な年数があることを意味します。

    制限事項

    Lindorm (LindormTSDB) データソースではサポートされていません。

    Lindorm (LindormTable, マルチモデル SQL) データソース バージョン 2.8 以降でのみサポートされています。

    BI_DATETRUNC

    BI_DATETRUNC は、日付を指定されたレベル (日、月、四半期、年など) に切り捨て、そのレベルの最初の日付を返します。

    構文

    BI_DATETRUNC(date, date_part)

    パラメータ

    • date: 返される日付。

    • date_part: 切り捨ての時間単位。サポートされている値 (大文字と小文字を区別しない) は次のとおりです。

      Year: 年

      四半期

      month: 月

      Week: 週

      day: 日

      時間

      Minute: 分

      第2

    定義

    <date> を <date_part> の精度に切り捨てます。たとえば、月に切り捨てると、その月の最初の日が返されます。

    出力

    日付

    例

    BI_DATETRUNC('2020-09-29', 'day') = 2020-09-29

    BI_DATETRUNC('2020-09-29', 'quarter') = 2020-07-01

    制限事項

    Lindorm データソースではサポートされていません。

    BI_DAY

    BI_DAY は、日付から月の日にちを返します。

    構文

    BI_DAY(date)

    パラメータの説明

    date: 返される日付。

    定義

    <date> から月の日にちを整数として返します。

    出力

    整数

    例

    BI_DAY('2020-09-29') = 29

    BI_DAYOFWEEK

    構文

    BI_DAYOFWEEK(date, <start>)

    パラメータ

    • date: 入力日付。

    • start: 週の最初の日。デフォルトは「Mon」です。サポートされている値 (大文字と小文字を区別しない) は次のとおりです。

      Mon: 月曜日

      Tue: 火曜日

      Wed: 水曜日

      Thu: 木曜日

      Fri: 金曜日

      Sat: 土曜日

      Sun: 日曜日

    定義

    <date> の週内の曜日番号を返します。

    週は <start> から始まります。<start> はオプションで、デフォルトは「Mon」です。

    出力

    数値

    例

    BI_DAYOFWEEK("2024-05-22", "Mon") = 3

    BI_DAYOFWEEK("2024-09-29", "Mon") = 7

    BI_MAKEDATE

    BI_MAKEDATE は、年、月、日の値から日付を構築します。

    構文

    BI_MAKEDATE(year, month, day)

    パラメータ

    • year: 年の値。

    • month: 月の値。

    • day: 日の要素。

    定義

    <year>、<month>、<day> から構築された日付を返します。

    出力

    日付

    例

    BI_MAKEDATE(2020, 9, 29) = 2020-09-29

    制限事項

    Lindorm (LindormTable, マルチモデル SQL) データソース バージョン 2.8 以降でのみサポートされています。

    BI_MONTH

    BI_MONTH は、日付から月を返します。

    構文

    BI_MONTH(date)

    パラメータの説明

    date: 月を抽出する日付。

    定義

    <date> から月を整数として返します。

    出力

    整数

    例

    BI_MONTH('2020-09-29') = 9

    BI_NOW

    BI_NOW は、現在時刻を返します。

    構文

    BI_NOW()

    定義

    現在時刻を返します。

    出力

    日付

    例

    BI_NOW() = 2024-05-22 09:29:29

    BI_QUARTER

    BI_QUARTER は、日付から四半期を返します。

    構文

    BI_QUARTER(date)

    パラメータの説明

    date: 返される四半期を指定する日付。

    定義

    <date> から四半期を整数として返します。

    出力

    整数

    例

    BI_QUARTER('2020-09-29') = 3

    BI_TODAY

    BI_TODAY は、現在の日付を返します。

    構文

    BI_TODAY()

    定義

    現在の日付を返します。

    出力

    日付

    例

    BI_TODAY() = 2024-05-22

    BI_WEEK

    BI_WEEK は、日付から週番号を返します。

    構文

    BI_WEEK(date)

    パラメータの説明

    date: 返される週の日付。

    定義

    <date> から週番号を整数として返します。

    出力

    整数

    例

    BI_WEEK('2010-01-01') = 52

    BI_WEEK('2010-01-06') = 1

    BI_YEAR

    BI_YEAR は、日付から年を返します。

    構文

    BI_YEAR(date)

    パラメータ

    date: 年を抽出する日付。

    定義

    <date> から年を整数として返します。

    出力

    整数

    例

    BI_YEAR('2020-09-29') = 2020