• 製品
  • 関連ドキュメント
  • リソース

変数の日付関数と時刻関数

相対日付変数と日時ダッシュボード変数に対して関数を実行して、必要に応じて返される日付をカスタマイズできます。変数に関する詳細をご確認ください。

次の日付と時刻の関数を利用できます。

  • ADD()

  • SUB()

  • PART()

  • BUCKET()

次の簡単な例を使ってお試しください。

  1. グローバル メニューから [作成] > [チャート] の順に選択します。

  2. クエリを SQL モードに切り替えます。

  3. SQL エディターに SELECT {CURRENT_CALENDAR_YEAR.START.SUB(1,'day')} と入力します

これは、前年の最後の日付を返します。

時間の単位

次の時間単位は、どの日付と時刻の関数でも使用できます。

  • 四半期 (PART 関数でのみ使用可能)

これらの単位には、単数形または複数形のいずれかを使用できます。


加算または減算

日時変数に時間の単位を加算または減算して、他の日付を計算できます。

日時変数に加算するには、次の ADD 関数を使用します。

1 {DATE_VARIABLE.ADD(integer, 'units')}

日時変数から減算するには、次の SUB 関数を使用します。

1 {DATE_VARIABLE.SUB(integer, 'units')}

次のように置き換えます。

  • DATE_VARIABLE を修正したい日時変数に置き換える

  • integer を変数に加算または減算する単位の数と置き換えます。

  • units を使用可能な単位オプションのいずれかと置き換えます。単位は一重引用符で囲まれていることにご注意ください。

SUB 関数の使用例

前月の最初の日付を取得する

SUB 関数を使用して、現在の月の開始日から 1 か月を引くことができます。

1 {CURRENT_MONTH.START.SUB(1,'month')}

前月の最終日付の取得

SUB 関数を使用すると、現在の月の開始日から 1 日が引かれます

1 {CURRENT_MONTH.START.SUB(1,'day')}

PART 関数

PART() は、日付の特定の部分を抽出して数値として返すので、他の計算にも使用できます。

一般的な形式は次のとおりです。

1 {DATE_VARIABLE.PART('units')}

次のように置き換えます。

  • DATE_VARIABLE を抽出したい日時変数に置き換える

  • units を使用可能な単位オプションのいずれかと置き換えます。単位は一重引用符で囲まれていることにご注意ください。

PART 関数の使用例

現在日付の四半期を取得する

1 {TODAY.PART('quarter')}

今日が 2020 年 3 月 30 日だった場合、これは 1 を返します。

今月の最初の日を取得する

1 {CURRENT_MONTH.END.PART('day')}

今月が 3 月だった場合は、31 を返します。

現在の年を取得する

1 {TODAY.PART('year')}

今日が 2020 年 3 月 30 日だった場合、これは 2020 を返します。

BUCKET 関数

BUCKET() を使用すると、日付を指定されたタイム バケットに変換し、日付文字列として返すことができます。

一般的な形式は次のとおりです。

1 {DATE_VARIABLE.BUCKET('units')}

BUCKET 関数の使用例

前月の月と年を取得する

1 {CURRENT_MONTH.START.SUB(1, 'month').BUCKET('month')}

今月が 2020 年 3 月だった場合、これは 2020-02 を返します。

これは、SUB 関数と BUCKET 関数を連鎖できる方法を示す良い例でもあります。

現在日付の ISO 週の日付を取得する

1 {TODAY.BUCKET('week')}

今日が 2020 年 3 月 30 日だった場合、これは 2020-W14 を返します。

現在日付の四半期の日付を取得する

1 {TDOAY.BUCKET('quarter')}

今日が 2020 年 3 月 30 日だった場合、これは 2020-Q1 を返します。


日付と時刻の関数を組み合わせる

相対日付変数は、柔軟な日付範囲でデータをフィルタリングする場合に役立ちます。日付と時刻の関数を 1 つだけ適用しても、必要としているほど柔軟にならない場合があります。そのような場合は、複数の日付と時刻の関数を連結して、変数に適用できます。

たとえば、昨日までの 1 週間すべてのデータを取得する場合は、2 つの相対日付変数 {TODAY.SUB(1,'day')}{TODAY.SUB(1,'week')} を次のように開始日の変数に組み合わせることができます。

1 {TODAY.SUB(1,'day').SUB(1,'week')}

次に、終了日に次の変数を使用して、今日の前の日 (つまり昨日) を取得できます。

1 {TODAY.SUB(1,'day')}

今日が 2020 年 3 月 30 日だった場合、それぞれ 2020-03-222020-03-29 が返されます。


日付と時刻の関数にネストされたダッシュボード変数

「Hidden variable」、「Text input」、または日付と時刻の関数のうち別のタイプのコントロールを参照する必要がある場合は、ダッシュボード変数を囲む波かっこを省略する必要があります。

たとえば、整数値を取り込む DAYS と呼ばれる「テキスト入力」コントロールがあるとします。その値を日付と時刻の関数で使用して、今日の # 日前に作成されたデータを動的に選択したいとします。# とは、{DAYS} 変数の値です。この場合、関数は次のようになります。

1 {TODAY.SUB(DAYS, 'days')}
相対日付変数に適用される日付と時刻関数内のダッシュボード変数を参照します。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。