はじめに
このリファレンスガイドでは、Beast Modeでサポートされている関数についてご紹介します。
動画 - Beast Modeの紹介
サポートされている機能
以下のどの関数も計算で使用することができます。「Beast Mode計算例」で多数の関数の例を参照できます。
集計関数
関数名 |
説明 |
例 |
---|---|---|
|
列内のユニーク値のおおよその数を返します。 |
|
|
列内の各系列の平均値を返します。 |
|
|
列内の各系列の最高値を返します。 この関数は、CEILINGは四捨五入するのに対し、MAXでは四捨五入しないという点で、MAX関数とは異なります。 |
|
|
列内の行の値の数を返します。 |
|
|
列内のユニーク値の数を返します。 |
|
|
数値列の各系列の最低値を返します。 この関数は、FLOORが四捨五入されMINが四捨五入されないという点で、MIN関数とは異なります。 |
|
|
数値列内の各系列の最高値を返します。 この関数は、CEILINGは四捨五入するのに対し、MAXはしないという点で、CEILING関数とは異なります。 |
|
|
数値列の各系列の最低値を返します。 この関数は、FLOORは四捨五入するのに対して、MINはしないという点で、FLOOR関数とは異なります。 |
|
|
数値列の各系列の母標準偏差を返します。 |
|
|
数値列の各系列の合計値を返します。 |
|
|
数値列内のユニーク値の合計値を返します。 |
|
|
数値列の各系列の母標準分散を返します。 |
|
まとめ数字に集計関数を使用する方法については、「まとめ数字に計算を適用する」をご覧ください。
数学関数
関数名 |
説明 |
例 |
---|---|---|
|
数値列内のすべての値の絶対値を返します。 つまり、どのようなマイナス数値も正になり、正の数値はそのままです。これは、正の値か負の値かを考慮せずに集計値を知りたい場合に役立ちます。 |
|
|
指定した数値で割った数値列の各値(被除数)の余りを返します。 |
|
|
指定の数値を乗じた数値列内の各値を返します。列に複数の系列が含まれている場合、各系列に対して数値が足されます。 |
|
|
0から1の間の乱数値を返します。 |
|
|
指定された小数位で四捨五入された数値列内の値を返します。 関数に小数値を含めていない場合、返される値は、整数の近似値となります。 |
|
論理関数
関数名 |
説明 |
例 |
---|---|---|
|
一定の基準を満たすとデータの値が置き換えられるような論理ステートメントを開始するのに使用します(when...thenやwhen...then, elseなど)。これらのステートメントは以下のフォーマットを使用します。 または
つまり、「Value」列内のデータがxのとき、値resultxを返します。それ以外の場合は、値resultyを返します(返された数値はシングルクォートを使った文字列か単一の数になります)。 複数の条件付きステートメントには、以下の関数を使用します。 無効ではありませんが、次の関数は非効率的なので使用しないようにします。 IN演算子 LIKE演算子
LIKE演算子の値は、WHENステートメントの順番で一致します。例えば、データ内の値が1番目と4番目のLIKE演算子と一致する場合、その値は最初の演算に適用されます。 |
|
|
null値を置き換える値を指定する場合に論理ステートメントで使用されます。 |
|
|
最初の列の値と2番目の列の値が等しい場合、nullを返します。それ以外の場合は、最初の列の値を返します。 |
|
動画 - Case文の概要
文字列関数
関数 |
説明 |
例 |
---|---|---|
|
2つ以上の文字列の列の文字列を結合します。 |
|
|
特定の列内で指定した文字列が最初に出現する位置を、名前の最初の文字から数えて返します。 右側の例では、この計算は列内の各文字列において、「e」が最初に出現する位置を返します。 |
|
|
左側から始めて、特定の列内の各文字列から指定された数の文字を返します。 |
|
|
特定の列内にある各文字列の文字数を返します。 |
|
|
1つ以上の文字列の列の文字列を小文字に変換します。 |
|
|
特定の列内の指定文字列を、すべて別の指定文字列に置き換えます。 |
|
|
右側から始めて、指定された数の文字を特定の列内から返します。 |
|
|
文字列の列内の値から指定した文字数を抽出し返します。 開始する位置と文字数を指定することで、返す文字を指定します。例えば、位置を1、文字数を3と指定すると、列内の値の1番目、2番目、3番目の文字を返します。 |
|
|
文字列の列内のすべての値の先頭にあるスペースと末尾にあるスペースを削除します。 |
|
|
1つ以上の文字列の列の文字列を大文字に変換します。 |
|
日付と時刻設定関数
関数 |
説明 |
例 |
---|---|---|
|
日付列の日付の値に(間隔として)日付または日時の値を追加します。 日付列の日付の値に追加する日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えばADDDATE(`datecolumn`, interval expr unit)の場合、datecolumnが日付の値を含む列であり、exprが追加する日付または日時の値を含む引数で、unitが対応する日付または日時の単位の種類の文字列です。 「-」を数式の冒頭に入力し、この数値を引くことができます。単位の数値(秒、分、時、日、週、月、四半期、年など)を指定できます(「間隔」のキーワードと、単位の種類の値には大文字と小文字の区別はありません)。詳細は、「Beast Modeでの単位の種類の値」を参照してください。 例えば、1月4日に12日を追加すると、1月16日を返します。 DATE_ADDと同じです。 |
|
|
時刻列内の値すべてに指定の秒数を追加します。例えば、8:05に15秒を追加すると、8:20を返します。 |
|
|
現在の日付を返します。 この関数では列の名前は指定されていません。 CURRENT_DATEと同じです。 |
|
|
現在の時刻を返します。 この関数では列の名前は指定されていません。 CURRENT_TIMEと同じです。 |
|
|
現在の日付を返します。 この関数では列の名前は指定されていません。 CURDATEと同じです。 |
|
|
現在の時刻を返します。 この関数では列の名前は指定されていません。 CURTIMEと同じです。 |
|
|
現在の日付と時間の値をYYYY-MM-DD HH:MM:SS形式で返します。 この関数では列の名前は指定されていません。 NOWと同じです。 |
|
|
日時の値から日付を抽出し、返します。 |
|
|
日時の値から2つの日付の間の日数を返します。 |
|
|
日付列の日付の値に(間隔として)日付または日時の値を追加します。 日付列の日付の値に追加する日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えばDATE_ADD(`datecolumn`, interval expr unit)の場合、datecolumnが日付の値を含む列であり、exprが追加する日付または日時の値を含む引数で、unitが対応する日付または日時の単位の種類の文字列です。 「-」 を数式の冒頭に入力し、この数値を引くことができます。単位の数値(秒、分、時、日、週、月、四半期、年など)を指定できます(「間隔」のキーワードと、単位の種類の値には大文字と小文字の区別はありません)。詳細は、「Beast Modeでの単位の種類の値」をご覧ください。 例えば、1月4日に12日を追加すると、1月16日を返します。 ADDDATEと同じです。 |
|
|
日付/時刻列の日付を指定の形式に設定します。 注記:Beast Modeでは、SQLと同じ日付と時刻の形式を使用します。
日付列または時刻列に使用する書式を指定することができます。これは、列や日付または時刻の文字列を指定することで行います。例えばDATE_FORMAT(`datecolumn`,'format')の場合、datecolumnは日付の値を含む列であり、formatは日付の値の書式に使用される指定子を含む文字列です。 「%」は指定文字列の前に使用する必要があります。 例えば、DATE_FORMAT(`MyDate`,'%Y-%m-%d %h:%i %p')を使用すると、MyDateの日付列の日付は「2013-04-17 10:10 AM」の形式になります。 指定文字列について詳しくは、「Beast Modeでの日付の形式指定文字列」を参照してください。 TIME_FORMATと同じです。 |
|
|
日付列内の日付の値から(間隔として)日付または日時の値を引きます。 日付列の日付の値に追加する日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えばDATE_SUB(`datecolumn`, interval expr unit)の場合、datecolumnが日付の値を含む列であり、exprが引く日付または日時の値を含む引数で、unitが対応する日付または日時の単位の種類の文字列です。 「-」を数式の冒頭に入れてこの数値を足すことができます。単位の数値(秒、分、時、日、週、月、四半期、年など)を指定できます(「間隔」のキーワードと、単位の種類の値には大文字と小文字の区別はありません)。詳細については、「Beast Modeでの単位の種類の値」を参照してください。 例えば、1月24日から12日を引くと1月12日を返します。 SUBDATEと同じです。 |
|
|
日付/時刻列のすべての値の月の日付を数値で返します。 DAYOFMONTHと同じです。 |
|
|
日付/時刻列のすべての値の曜日名を返します。 |
|
|
日付/時刻列のすべての値の月の日付を数値で返します。 DAYと同じです。 |
|
|
日付/時刻列のすべての値の曜日を数値で返します(例:「月曜日」の場合は「2」)。 |
|
|
日付/時刻列のすべての値を一年の何日目であるかの数値で返します(例:1年の226日目は「226」です)。 |
|
|
日付の数値を日付に変換します。 |
|
FROM_UNIXTIME |
指定された形式を使ってUNIXの日付/時刻列からUNIX日時の値を返します。 指定文字列の詳細に関しては、「Beast Modeでの日付の形式指定文字列」をご覧ください。 |
|
|
日付/時刻列内のすべての値の正時を返します(例:時刻が「3:36」の場合、「3」を返します)。 |
|
|
日付/時刻列の各月の値を集計し、各月の最終日に集計した値を返します。 例えば、1月の日付/時刻の列に「15」、「16」、「17」があると、その最後の日付と3つの数字を足した48の数値のみが表示されます。 |
|
|
時刻列内の各時刻(分)の値を返します。 列に特定の時刻(分)の例が1つ以上存在する場合は、該当する時刻(分)の値が集計されます。 |
|
|
日付/時刻列内のすべての値の月を数値で返します(例:9月の場合「9」)。 |
|
|
日付/時刻列内のすべての値の月の名前を返します(例:「9」ではなく「9月」)。 |
|
|
現在の日付と時間の値をYYYY-MM-DD HH:MM:SS形式で返します。 この関数では列の名前は指定されていません。 CURRENT_TIMESTAMPと同じです。 |
|
|
日付列内の値に指定の月数を追加します。これが機能するには、日付の値はYYYYMM形式での月になっている必要があります。 |
|
|
2つの日付列内の月の間の月数を返します。 これが機能するには、日付の値はYYYYMM形式での月になっている必要があります。例えば、1つの列に200803の日付値があり、他の列に200809の数値がある場合、この関数は6を返します。 |
|
|
日付の値データを四半期に集計します。 |
|
|
時刻列の各時刻(秒)の値を返します。列内に特定の時刻(秒)の例が1つ以上存在する場合は、該当する時刻(秒)の値が集計されます。 |
|
|
秒を時間、分、秒に変換します。例えば、3489秒は00:58:09に変換されます。 |
|
|
1つ以上の文字列の列の文字列(Domoが日付として認識しない文字列)を日時の値に変換します。列と現在列で使用されている日付の形式を指定してください。 デフォルトとして、日時の数値は%m-%d-%Yの出力形式を返します。STR_TO_DATE計算を、使用したい日付形式の指定子の文字を指定したDATE_FORMAT計算で囲むことにより、出力形式を変更することができます。 指定文字列について詳しくは、「Beast Modeでの日付の形式指定文字列」を参照してください。 |
|
|
日付列内の日付の値から(間隔として)日付または日時の値を引きます。 日付列の日付の値から引く日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えばSUBDATE(`datecolumn`, interval expr unit)の場合、datecolumnが日付の値を含む列であり、exprが引く日付または日時の値を含む引数で、unitが対応する日付または日時の単位の種類の文字列です。 「-」を数式の冒頭に入れてこの数値を足すことができます。単位の数値(秒、分、時、日、週、月、四半期、年など)を指定できます(「間隔」のキーワードと、単位の種類の値には大文字と小文字の区別はありません)。詳細については、「Beast Modeでの単位の種類の値」を参照してください。 例えば、1月24日から12日を引くと1月12日を返します。DATE_SUBと同じです。 |
|
|
時刻列内の値すべてから指定の秒数を引きます。 例えば8:05:45から30秒を引くと、8:05:15を返します。 |
|
|
現在の日付と時刻をYYYY-MM-DD HH:MM:SS形式で返します(例:2014-04-03T19:25:29)。 この関数では列の名前は指定されていません。 CURRENT_DATEやCURRENT_TIMEと同じです。 |
|
|
日時の値から時間を抽出します。 |
|
|
2つの日付/時刻列内の値の差を時間の値として返します。 |
|
|
日付列の値を日時の値として返します。 |
|
|
日時列の時間を指定の形式に設定します。 注記:Beast Modeでは、SQLと同じ日付と時刻の形式を使用します。
列や時間の文字列を指定することにより、時間列の時間値に使用する形式を指定することができます。TIME_FORMAT(`datetimecolumn`,'format')の場合、datetimecolumnは時間の値を含む列であり、formatが時間値の書式設定に使用される指定子を含む文字列です。 注記:DATE_FORMATで使用される形式の指定子はTIME_FORMATと併用できますが、時、分、秒、マイクロ秒以外の指定子は、NULL値または0を生成します。
「%」は指定文字列の前に使用する必要があります。 例えば、TIME_FORMAT(`Date`,'%h:%i:%s')を使うと、変換済みの時間列の日付はこの形式になります:12:20:12 指定文字列について詳しくは、「Beast Modeでの日付の形式指定文字列」を参照してください。 DATE_FORMATと同じです。 |
|
|
日付/時刻列のすべての値の経過時間(秒)を返します。 |
|
|
日付/時刻列のすべての値の0年からの日数を返します。例えば、日付「01-06-2010」は、0年1月1日からこの日付までに734,143日間経過しているため、「734143」が返されます。 |
|
UNIX_TIMESTAMP |
日付/時刻列のすべての値のUNIXタイムスタンプを返します。 | UNIX_TIMESTAMP(`DateCol`) |
WEEK |
指定された日付または日時列の各値の週の番号を返します。 構文:WEEK(`dateCol`, mode)。 日~土の週フレームの場合、モード11を使用します(例:WEEK(`dateCol`, 11))。 月~日の週フレームの場合、モード22を使用します(例:WEEK(`dateCol`, 22))。 |
WEEK(`DateCol`,22) |
|
日付/時刻列の値すべての年を返します。 |
|
|
指定された日付または日時列の各値の週の番号を、「YYYYWW」の形式で返します。例えば、2020年の第5週の日付であれば、「202005」が返されます。 構文:YEARWEEK(`dateCol`, mode) 日~土の週フレームの場合、モード11を使用します(例:YEARWEEK(`dateCol`, 11))。 月~日の週フレームの場合、モード22を使用します(例:YEARWEEK(`dateCol`, 22))。 |
|
サポートされていない機能
以下の関数は、サポートが終了しています。SQRT
、CONVERT_TZ
、MICROSECOND
、WEEKDAY
コメント
0件のコメント
サインインしてコメントを残してください。