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

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

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

• ADD()

• SUB()

• PART()

• BUCKET()

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

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

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

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

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

時間の単位

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

• 日

• 週

• 月

• 年

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

加算または減算

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

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

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

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

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

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

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

SUB 関数の使用例

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

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

前月の最終日付の取得

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

PART 関数

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

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

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

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

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

PART 関数の使用例

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

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

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

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

現在の年を取得する

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

BUCKET 関数

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

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

BUCKET 関数の使用例

前月の月と年を取得する

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

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

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

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

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

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

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

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

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

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

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

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

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

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