はじめに
このリファレンスガイドでは、Beast Modeでサポートされている関数について説明します。サポートされている関数
計算では、以下の関数を使用することができます。以下の記事で、多くの関数の例を参照することができます。集計関数
関数名 | 説明 | 例 |
|---|---|---|
| 列内のユニーク値のおおよその数を返します。 |
|
| 列内の各系列の平均値を返します。 |
|
| 列内の各系列の最高値を返します。 この関数は、 |
|
| 列内の行の値の数を返します。 |
|
| 列内のユニーク値の数を返します。 |
|
| 数値列の各系列の最低値を返します。 この関数は、 |
|
| 数値列内の各系列の最高値を返します。 この関数は、 |
|
| 数値列の各系列の最低値を返します。 この関数は、 |
|
| 数値列の各系列の母標準偏差を返します。 |
|
| 数値列の各系列の合計値を返します。 |
|
| 数値列内のユニーク値の合計値を返します。 |
|
| 数値列の各系列の母標準分散を返します。 |
数学関数
関数名 | 説明 | 例 |
|---|---|---|
| 数値列内のすべての値の絶対値を返します。 つまり、どのようなマイナス数値も正になり、正の数値はそのままです。これは、正の値か負の値かを考慮せずに集計値を知りたい場合に役立ちます。 |
|
| 指定した数値で割った数値列の各値(被除数)の余りを返します。 |
|
| 指定の数値を乗じた数値列内の各値を返します。列に複数の系列が含まれている場合、各系列に対して数値が足されます。 |
|
| 0から1の間の乱数値を返します。 |
|
| 関数に小数値を含めていない場合、返される値は、整数の近似値となります。 |
|
論理関数
関数名 | 説明 | 例 |
|---|---|---|
| 一定の基準を満たすとデータの値が置き換えられるような論理ステートメントを開始するのに使用します(when…thenやwhen…then, elseなど)。これらのステートメントは以下のフォーマットを使用します。 または
つまり、「Value」列内のデータが x のとき、値 resultx を返します。それ以外の場合は、値 resulty を返します(返された数値はシングルクォートを使った文字列か単一の数になります)。 複数の条件付きステートメントには、以下の関数を使用します。 無効ではありませんが、次の関数は非効率的なので使用しないようにします。 IN演算子 LIKE演算子
| |
| null値を置き換える値を指定する場合に論理ステートメントで使用されます。 |
|
| 最初の列の値と2番目の列の値が等しい場合、nullを返します。それ以外の場合は、最初の列の値を返します。 |
|
文字列関数
関数 | 説明 | 例 |
|---|---|---|
| 2つ以上の文字列の列の文字列を結合します。 |
|
| 特定の列内で指定した文字列が最初に出現する位置を、名前の最初の文字から数えて返します。 右側の例では、この計算は列内の各文字列において、「e」が最初に出現する位置を返します。 |
|
| 左側から始めて、特定の列内の各文字列から指定された数の文字を返します。 |
|
| 特定の列内にある各文字列の文字数を返します。 |
|
| 1つ以上の文字列の列の文字列を小文字に変換します。 |
|
| 特定の列内の指定文字列を、すべて別の指定文字列に置き換えます。 |
|
| 右側から始めて、指定された数の文字を特定の列内から返します。 |
|
| 文字列の列内の値から指定した文字数を抽出し返します。 開始する位置と文字数を指定することで、返す文字を指定します。例えば、位置を1、文字数を3と指定すると、列内の値の1番目、2番目、3番目の文字を返します。 |
|
| 文字列の列内のすべての値の先頭にあるスペースと末尾にあるスペースを削除します。 |
|
| 1つ以上の文字列の列の文字列を大文字に変換します。 |
日付と時刻設定関数
WEEKDAY 関数はサポートされていません。 WEEKDAY を使用する場合は、 DAYOFWEEK の機能に置き換えられます。関数 | 説明 | 例 |
|---|---|---|
| 日付列の日付の値に(間隔として)日付または日時の値を追加します。 日付列の日付の値に追加する日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えば 「-」を数式の冒頭に入力し、この数値を引くことができます。単位の数値(秒、分、時、日、週、月、四半期、年など)を指定できます(「間隔」のキーワードと、単位の値には大文字と小文字の区別はありません)。詳細については、「 Beast Modeの日付形式の指定文字列 」の「単位の値」セクションを参照してください。 例えば、
|
|
| 時刻列内の値すべてに指定の秒数を追加します。例えば、 |
|
| 現在の日付を返します。 この関数では列の名前は指定されていません。
|
|
| 現在の時刻を返します。 この関数では列の名前は指定されていません。
|
|
| 現在の日付を返します。 この関数では列の名前は指定されていません。
|
|
| 現在の時刻を返します。 この関数では列の名前は指定されていません。
|
|
| 現在の日付と時間の値を この関数では列の名前は指定されていません。
|
|
| 日時の値から日付を抽出し、返します。 |
|
| 日時の値から2つの日付の間の日数を返します。 |
|
| 日付列の日付の値に(間隔として)日付または日時の値を追加します。 日付列の日付の値に追加する日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えば 「-」 を数式の冒頭に入力し、この数値を引くことができます。単位の数値(秒、分、時、日、週、月、四半期、年など)を指定できます(「間隔」のキーワードと、単位の値には大文字と小文字の区別はありません)。詳細については、「 Beast Modeの日付形式の指定文字列 」の「単位の値」セクションを参照してください。 例えば、
|
|
| 日付/時刻列の日付を指定の形式に設定します。 日付列または時刻列に使用する書式を指定することができます。これは、列や日付または時刻の文字列を指定することで行います。例えば 「%」は指定文字列の前に使用する必要があります。 例えば、 指定文字列の詳細に関しては、「 Beast Modeでの日付の形式指定文字列 」を参照してください。
|
|
| 日付列内の日付の値から(間隔として)日付または日時の値を引きます。 日付列の日付の値に追加する日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えば 「-」を数式の冒頭に入れてこの数値を足すことができます。単位の数値(秒、分、時、日、週、月、四半期、年など)を指定できます(「間隔」のキーワードと、単位の値には大文字と小文字の区別はありません)。詳細については、「 Beast Modeの日付形式の指定文字列 」の「単位の値」セクションを参照してください。 例えば、
|
|
| 日付/時刻列のすべての値の月の日付を数値で返します。
|
|
| 日付/時刻列のすべての値の曜日名を返します。 |
|
| 日付/時刻列のすべての値の月の日付を数値で返します。
|
|
| 日付/時刻列のすべての値の曜日を数値で返します(例:「月曜日」の場合は「2」)。 |
|
| 日付/時刻列のすべての値を一年の何日目であるかの数値で返します(例:1年の226日目は「226」です)。 |
|
| 日付の数値を日付に変換します。 |
|
FROM_UNIXTIME | 指定された形式を使ってUNIXの日付/時刻列からUNIX日時の値を返します。 指定文字列の詳細に関しては、「 Beast Modeでの日付の形式指定文字列 」を参照してください。 |
|
| 日付/時刻列内のすべての値の正時を返します(例:時刻が「3:36」の場合、「3」を返します)。 |
|
| 日付/時刻列の各月の値を集計し、各月の最終日に集計した値を返します。 例えば、1月の日付/時刻の列に「15」、「16」、「17」があると、その最後の日付と3つの数字を足した48の数値のみが表示されます。 |
|
| 時刻列内の各時刻(分)の値を返します。 列に特定の時刻(分)の例が1つ以上存在する場合は、該当する時刻(分)の値が集計されます。 |
|
| 日付/時刻列内のすべての値の月を数値で返します(例:9月の場合「9」)。 |
|
| 日付/時刻列内のすべての値の月の名前を返します(例:「9」ではなく「9月」)。 |
|
| 現在の日付と時間の値を この関数では列の名前は指定されていません。
|
|
| 日付列内の値に指定の月数を追加します。これが機能するには、日付の値は |
|
| 2つの日付列内の月の間の月数を返します。 これが機能するには、日付の値は |
|
| 日付の値データを四半期に集計します。 |
|
| 時刻列の各時刻(秒)の値を返します。列内に特定の時刻(秒)の例が1つ以上存在する場合は、該当する時刻(秒)の値が集計されます。 |
|
| 秒を時間、分、秒に変換します。例えば、 |
|
| 1つ以上の文字列の列の文字列(Domoが日付として認識しない文字列)を日時の値に変換します。列と現在列で使用されている日付の形式を指定してください。 デフォルトとして、日時の数値は 指定文字列の詳細に関しては、「 Beast Modeでの日付の形式指定文字列 」を参照してください。 |
|
| 日付列内の日付の値から(間隔として)日付または日時の値を引きます。 日付列の日付の値から引く日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えば 「-」を数式の冒頭に入れてこの数値を足すことができます。単位の数値(秒、分、時、日、週、月、四半期、年など)を指定できます(「間隔」のキーワードと、単位の値には大文字と小文字の区別はありません)。詳細については、「 Beast Modeの日付形式の指定文字列 」の「単位の値」セクションを参照してください。 例えば、 |
|
| 時刻列内の値すべてから指定の秒数を引きます。 例えば |
|
| 現在の日付と時刻をYYYY-MM-DD HH:MM:SS形式で返します(例: この関数では列の名前は指定されていません。
|
|
| 日時の値から時間を抽出します。 |
|
| 2つの日付/時刻列内の値の差を時間の値として返します。 |
|
| 日付列の値を日時の値として返します。 |
|
| 日時列の時間を指定の形式に設定します。 列や時間の文字列を指定することにより、時間列の時間値に使用する形式を指定することができます。 「%」は指定文字列の前に使用する必要があります。 例えば、 指定文字列について詳しくは、「 Beast Modeでの日付の形式指定文字列 」を参照してください。
|
|
| 日付/時刻列のすべての値の経過時間(秒)を返します。 |
|
| 日付/時刻列のすべての値の0年からの日数を返します。例えば、日付「01-06-2010」は、0年1月1日からこの日付までに734,143日間経過しているため、「734143」が返されます。 |
|
UNIX_TIMESTAMP | 日付/時刻列のすべての値のUNIXタイムスタンプを返します。 | UNIX_TIMESTAMP( |
WEEK | 指定された日付または日時列の各値の週の番号を返します。 構文: 日~土の週フレームの場合、モード11を使用します(例: 月~日の週フレームの場合、モード22を使用します(例: | WEEK( |
| 日付/時刻列の値すべての年を返します。 |
|
| 指定された日付または日時列の各値の週の番号を、「YYYYWW」の形式で返します。例えば、2020年の第5週の日付であれば、「202005」が返されます。 構文: 日~土の週フレームの場合、モード11を使用します(例: 月~日の週フレームの場合、モード22を使用します(例: |
|
計算をまとめ数字に適用する
DataSet内でBeast Mode計算が行を集計する場合、カードのまとめ数字に使用できます。以下のいずれかの関数を使用して作成された計算は、まとめ数字に適用できます。SUM()
関数)または、関数内で数値に行われた演算の結果である必要があります(例:
SUM()
関数)。例えば、
'Customers'
はまとめ数字として使えませんが、
SUM('Customers')
はまとめ数字として使うことができます。サポートされていない関数
SQRT
、
CONVERT_TZ
、
MICROSECOND
、
WEEKDAY
の各関数は、サポートが終了しています。
このページのトップへ
日本語