変数の日付関数と時刻関数
相対日付変数と日時ダッシュボード変数に対して関数を実行して、必要に応じて返される日付をカスタマイズできます。変数に関する詳細をご確認ください。
次の日付と時刻の関数を利用できます。
ADD()
SUB()
PART()
BUCKET()
次の簡単な例を使ってお試しください。
グローバル メニューから [作成] > [チャート] の順に選択します。
クエリを SQL モードに切り替えます。
SQL エディターに
SELECT {CURRENT_CALENDAR_YEAR.START.SUB(1,'day')}
と入力します
これは、前年の最後の日付を返します。
時間の単位
次の時間単位は、どの日付と時刻の関数でも使用できます。
日
週
月
年
四半期 (
PART
関数でのみ使用可能)
これらの単位には、単数形または複数形のいずれかを使用できます。
加算または減算
日時変数に時間の単位を加算または減算して、他の日付を計算できます。
日時変数に加算するには、次の ADD
関数を使用します。
{DATE_VARIABLE.ADD(integer, 'units')}
日時変数から減算するには、次の SUB
関数を使用します。
{DATE_VARIABLE.SUB(integer, 'units')}
次のように置き換えます。
DATE_VARIABLE
を修正したい日時変数に置き換えるinteger
を変数に加算または減算する単位の数と置き換えます。units
を使用可能な単位オプションのいずれかと置き換えます。単位は一重引用符で囲まれていることにご注意ください。
SUB 関数の使用例
前月の最初の日付を取得する
SUB
関数を使用して、現在の月の開始日から 1 か月を引くことができます。
{CURRENT_MONTH.START.SUB(1,'month')}
前月の最終日付の取得
SUB
関数を使用すると、現在の月の開始日から 1 日が引かれます
{CURRENT_MONTH.START.SUB(1,'day')}
PART 関数
PART()
は、日付の特定の部分を抽出して数値として返すので、他の計算にも使用できます。
一般的な形式は次のとおりです。
{DATE_VARIABLE.PART('units')}
次のように置き換えます。
DATE_VARIABLE
を抽出したい日時変数に置き換えるunits
を使用可能な単位オプションのいずれかと置き換えます。単位は一重引用符で囲まれていることにご注意ください。
PART 関数の使用例
現在日付の四半期を取得する
{TODAY.PART('quarter')}
今日が 2020 年 3 月 30 日だった場合、これは 1
を返します。
今月の最初の日を取得する
{CURRENT_MONTH.END.PART('day')}
今月が 3 月だった場合は、31
を返します。
現在の年を取得する
{TODAY.PART('year')}
今日が 2020 年 3 月 30 日だった場合、これは 2020
を返します。
BUCKET 関数
BUCKET()
を使用すると、日付を指定されたタイム バケットに変換し、日付文字列として返すことができます。
一般的な形式は次のとおりです。
{DATE_VARIABLE.BUCKET('units')}
BUCKET 関数の使用例
前月の月と年を取得する
{CURRENT_MONTH.START.SUB(1, 'month').BUCKET('month')}
今月が 2020 年 3 月だった場合、これは 2020-02
を返します。
これは、SUB
関数と BUCKET
関数を連鎖できる方法を示す良い例でもあります。
現在日付の ISO 週の日付を取得する
{TODAY.BUCKET('week')}
今日が 2020 年 3 月 30 日だった場合、これは 2020-W14
を返します。
現在日付の四半期の日付を取得する
{TDOAY.BUCKET('quarter')}
今日が 2020 年 3 月 30 日だった場合、これは 2020-Q1
を返します。
日付と時刻の関数を組み合わせる
相対日付変数は、柔軟な日付範囲でデータをフィルタリングする場合に役立ちます。日付と時刻の関数を 1 つだけ適用しても、必要としているほど柔軟にならない場合があります。そのような場合は、複数の日付と時刻の関数を連結して、変数に適用できます。
たとえば、昨日までの 1 週間すべてのデータを取得する場合は、2 つの相対日付変数 {TODAY.SUB(1,'day')}
と {TODAY.SUB(1,'week')}
を次のように開始日の変数に組み合わせることができます。
{TODAY.SUB(1,'day').SUB(1,'week')}
次に、終了日に次の変数を使用して、今日の前の日 (つまり昨日) を取得できます。
{TODAY.SUB(1,'day')}
今日が 2020 年 3 月 30 日だった場合、それぞれ 2020-03-22
と 2020-03-29
が返されます。
日付と時刻の関数にネストされたダッシュボード変数
「Hidden variable」、「Text input」、または日付と時刻の関数のうち別のタイプのコントロールを参照する必要がある場合は、ダッシュボード変数を囲む波かっこを省略する必要があります。
For example, let’s say we have a “Text Input” control called DAYS that takes in integer values. We want to use the its value in a date and time function so we can dynamically select data created # days before today, where # is the value of the {DAYS}
variable. Our function would look like this:
{TODAY.SUB(DAYS, 'days')}
この内容はお役に立ちましたか?