> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Beast Mode関数リファレンスガイド

### はじめに

このリファレンスガイドでは、Beast Modeでサポートされている関数について説明します。

***

* [サポートされている関数](#supported_functions)
  * [集計関数](#aggregate)
  * [数学関数](#mathematical)
  * [論理関数](#logical)
  * [文字列関数](#string)
  * [日付と時刻設定関数](#date_and_time)
* [計算をまとめ数字に適用する](#summary_number)
* [サポートされていない関数](#unsupported)

***

### サポートされている関数

計算では、以下の関数を使用することができます。以下の記事で、多くの関数の例を参照することができます。

* [基本変換の例](/s/article/360043430073)
* [カード要素変換の例](/s/article/360043430093)
* [日付変換の例](/s/article/360042925494)
* [数学変換の例](/s/article/360042925514)
* [その他の変換の例](/s/article/360043430113)
* [前期比変換の例](/s/article/360043430133)

# 集計関数

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p> 関数名 </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th><th colspan="1" rowspan="1"><p> 例 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><code> APPROXIMATE COUNT (DISTINCT) </code></p></td><td colspan="1" rowspan="1"><p> 列内のユニーク値のおおよその数を返します。 </p></td><td colspan="1" rowspan="1"><p><code> APPROXIMATE\_COUNT\_DISTINCT(`Customers`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> AVG </code></p></td><td colspan="1" rowspan="1"><p> 列内の各系列の平均値を返します。 </p></td><td colspan="1" rowspan="1"><p><code> AVG(`Operating Budget`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> CEILING </code></p></td><td colspan="1" rowspan="1"><p> 列内の各系列の最高値を返します。 </p><p> この関数は、 <code> CEILING </code> は四捨五入するのに対し、 <code> MAX </code> は四捨五入しないという点で、 <code> MAX </code> 関数とは異なります。 </p></td><td colspan="1" rowspan="1"><p><code> CEILING(`Operating Budget`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> COUNT </code></p></td><td colspan="1" rowspan="1"><p> 列内の行の値の数を返します。 </p></td><td colspan="1" rowspan="1"><p><code> COUNT(`Customers`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> COUNT (DISTINCT) </code></p></td><td colspan="1" rowspan="1"><p> 列内のユニーク値の数を返します。 </p></td><td colspan="1" rowspan="1"><p><code> COUNT(DISTINCT `Customers`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> FLOOR </code></p></td><td colspan="1" rowspan="1"><p> 数値列の各系列の最低値を返します。 </p><p> この関数は、 <code> FLOOR </code> は四捨五入するのに対し、MINは四捨五入しないという点で、 <code> MIN </code> 関数とは異なります。 </p></td><td colspan="1" rowspan="1"><p><code> FLOOR(`Operating Budget`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> MAX </code></p></td><td colspan="1" rowspan="1"><p> 数値列内の各系列の最高値を返します。 </p><p> この関数は、 <code> CEILING </code> は四捨五入するのに対し、 <code> MAX </code> は四捨五入しないという点で、 <code> CEILING </code> 関数とは異なります。 </p></td><td colspan="1" rowspan="1"><p><code> MAX(`Operating Budget`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> MIN </code></p></td><td colspan="1" rowspan="1"><p> 数値列の各系列の最低値を返します。 </p><p> この関数は、 <code> FLOOR </code> は四捨五入するのに対し、 <code> MIN </code> は四捨五入しないという点で、 <code> FLOOR </code> 関数とは異なります。 </p></td><td colspan="1" rowspan="1"><p><code> MIN(`Operating Budget`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> STDDEV\_POP </code></p></td><td colspan="1" rowspan="1"><p> 数値列の各系列の母標準偏差を返します。 </p></td><td colspan="1" rowspan="1"><p><code> STDDEV\_POP(`Values`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> SUM </code></p></td><td colspan="1" rowspan="1"><p> 数値列の各系列の合計値を返します。 </p></td><td colspan="1" rowspan="1"><p><code> SUM(`Values`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> SUM (DISTINCT) </code></p></td><td colspan="1" rowspan="1"><p> 数値列内のユニーク値の合計値を返します。 </p></td><td colspan="1" rowspan="1"><p><code> SUM(DISTINCT `Values`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> VAR\_POP </code></p></td><td colspan="1" rowspan="1"><p> 数値列の各系列の母標準分散を返します。 </p></td><td colspan="1" rowspan="1"><p><code> VAR\_POP(`Values`) <a id="mathematical" target="_blank" /></code></p></td></tr></tbody></table>

まとめ数字で集計関数を使用する方法については、 [こちら](#summary_number) を参照してください。

[このページのトップへ](#intro)

# 数学関数

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p> 関数名 </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th><th colspan="1" rowspan="1"><p> 例 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><code> ABS </code></p></td><td colspan="1" rowspan="1"><p> 数値列内のすべての値の絶対値を返します。 </p><p> つまり、どのようなマイナス数値も正になり、正の数値はそのままです。これは、正の値か負の値かを考慮せずに集計値を知りたい場合に役立ちます。 </p></td><td colspan="1" rowspan="1"><p><code> ABS(`Operating Budget`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> MOD </code></p></td><td colspan="1" rowspan="1"><p> 指定した数値で割った数値列の各値（被除数）の余りを返します。 </p></td><td colspan="1" rowspan="1"><p><code> MOD(`Values`,2) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> POWER </code></p></td><td colspan="1" rowspan="1"><p> 指定の数値を乗じた数値列内の各値を返します。列に複数の系列が含まれている場合、各系列に対して数値が足されます。 </p></td><td colspan="1" rowspan="1"><p><code> POWER(`Values`,2) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> RAND </code></p></td><td colspan="1" rowspan="1"><p> 0から1の間の乱数値を返します。 </p></td><td colspan="1" rowspan="1"><p><code> RAND(`Values`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> ROUND </code></p></td><td colspan="1" rowspan="1"><p> 指定された小数位で四捨五入された数値列内の値を返します。 <a id="logical" target="_blank" /></p><p> 関数に小数値を含めていない場合、返される値は、整数の近似値となります。 </p></td><td colspan="1" rowspan="1"><p><code> ROUND(`Values`,1) </code></p></td></tr></tbody></table>

[このページのトップへ](#intro)

# 論理関数

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p> 関数名 </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th><th colspan="1" rowspan="1"><p> 例 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><code> CASE </code></p></td><td colspan="1" rowspan="1"><p> 一定の基準を満たすとデータの値が置き換えられるような論理ステートメントを開始するのに使用します（when...thenやwhen...then, elseなど）。これらのステートメントは以下のフォーマットを使用します。 <br /><br /><code> CASE `Value` when x then 'resultx' else 'resulty' End </code></p><p> または <br /></p><p><code> CASE when `Value`= <em> x </em> then 'resultx' else 'resulty' End </code></p><p> つまり、「Value」列内のデータが <em> x </em> のとき、値 <em> resultx </em> を返します。それ以外の場合は、値 <em> resulty </em> を返します（返された数値はシングルクォートを使った文字列か単一の数になります）。 </p><p> 複数の条件付きステートメントには、以下の関数を使用します。 <br /><br /><code> CASE when `Value`= <em> x </em> then 1 when `Value`= <em> y </em> then 2 end </code></p><p> 無効ではありませんが、次の関数は非効率的なので使用しないようにします。 <br /><br /><code> CASE when `Value`= <em> x </em> then 1 else CASE when `Value`= <em> y </em> then 2 end end </code></p><p><b> IN演算子 </b><br /><br /><code> CASE when </code> 節では、 <code> IN </code> 演算子を使用すると評価する値を複数指定できます。 <br /><br /><code> `column_name` IN (value1,value2,...) </code><br /><br /><br /><code> CASE when `State` in ('NY', 'TX') then 0 else 1 end </code></p><p><b> LIKE演算子 </b><br /><br /><code> CASE when </code> 節では、 <code> LIKE </code> 演算子を使って列内の特定パターンを検索できます。 <br /><br /><code> `column_name` LIKE pattern </code></p><p><code> CASE when `State` like '%TX%' or `State` like '%NY' then 0 else 1 end </code><br /><br /> ワイルドカードを <code> LIKE </code><code /> 演算子とともに使用できます。 </p><ul><li><p><code> % </code> は、ゼロ（0）を含む、あらゆる文字数に一致します。 <br /><code> like '%TX%' </code></p></li><li><p><code> \_ </code> は、正確に1文字に一致します。 <br /><code> like '\_hn%' </code></p></li></ul><p><code> LIKE </code> 演算子の値は、 <code> WHEN </code> ステートメントの順番で一致します。例えば、データ内の値が1番目と4番目の <code> LIKE </code> 演算子と一致する場合、その値は最初の演算に適用されます。 </p></td><td colspan="1" rowspan="1"><pre><code>CASE when `Amount`=1 then 10 else 0 End CASE `Gender` when 'M' then 'Male' when 'F' then 'Female' end​ CASE when `Pennies` >= 600 then 'Large' when `Pennies` \<= 300 then 'Small' else `Pennies` end​</code></pre><p /></td></tr><tr><td colspan="1" rowspan="1"><p><code> IFNULL </code></p></td><td colspan="1" rowspan="1"><p> null値を置き換える値を指定する場合に論理ステートメントで使用されます。 </p></td><td colspan="1" rowspan="1"><p><code> IFNULL(`Values`,0) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> NULLIF </code></p></td><td colspan="1" rowspan="1"><p> 最初の列の値と2番目の列の値が等しい場合、nullを返します。それ以外の場合は、最初の列の値を返します。 </p></td><td colspan="1" rowspan="1"><p><code> NULLIF(`Value 1`,`Value 2`) </code></p></td></tr></tbody></table>

**動画 - CASEステートメントの概要**

<iframe allowfullscreen="allowfullscreen" frameborder="0" height="315" src="//www.youtube-nocookie.com/embed/xFofhklohSc" width="560" />

[このページのトップへ](#intro)

# 文字列関数

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p> 関数 </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th><th colspan="1" rowspan="1"><p> 例 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><code> CONCAT </code></p></td><td colspan="1" rowspan="1"><p> 2つ以上の文字列の列の文字列を結合します。 </p></td><td colspan="1" rowspan="1"><p><code> CONCAT(`First Name`,' ',`Last Name`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> INSTR </code></p></td><td colspan="1" rowspan="1"><p> 特定の列内で指定した文字列が最初に出現する位置を、名前の最初の文字から数えて返します。 </p><p> 右側の例では、この計算は列内の各文字列において、「e」が最初に出現する位置を返します。 </p></td><td colspan="1" rowspan="1"><p><code> INSTR(`Group`,'e') </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> LEFT </code></p></td><td colspan="1" rowspan="1"><p> 左側から始めて、特定の列内の各文字列から指定された数の文字を返します。 </p></td><td colspan="1" rowspan="1"><p><code> LEFT(`Group`,3) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> LENGTH </code></p></td><td colspan="1" rowspan="1"><p> 特定の列内にある各文字列の文字数を返します。 </p></td><td colspan="1" rowspan="1"><p><code> LENGTH(`Group`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> LOWER </code></p></td><td colspan="1" rowspan="1"><p> 1つ以上の文字列の列の文字列を小文字に変換します。 </p></td><td colspan="1" rowspan="1"><p><code> LOWER(`Product Type`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> REPLACE </code></p></td><td colspan="1" rowspan="1"><p> 特定の列内の指定文字列を、すべて別の指定文字列に置き換えます。 </p></td><td colspan="1" rowspan="1"><p><code> REPLACE(`Department`,'Human Resnources','Human Resources') </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> RIGHT </code></p></td><td colspan="1" rowspan="1"><p> 右側から始めて、指定された数の文字を特定の列内から返します。 </p></td><td colspan="1" rowspan="1"><p><code> RIGHT(`Group`,3) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> SUBSTRING </code></p></td><td colspan="1" rowspan="1"><p> 文字列の列内の値から指定した文字数を抽出し返します。 </p><p> 開始する位置と文字数を指定することで、返す文字を指定します。例えば、位置を1、文字数を3と指定すると、列内の値の1番目、2番目、3番目の文字を返します。 </p></td><td colspan="1" rowspan="1"><p><code> SUBSTRING(`Employee Name`,1,3) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> TRIM </code></p></td><td colspan="1" rowspan="1"><p> 文字列の列内のすべての値の先頭にあるスペースと末尾にあるスペースを削除します。 </p></td><td colspan="1" rowspan="1"><p><code> TRIM(`Employee Name`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> UPPER </code></p></td><td colspan="1" rowspan="1"><p> 1つ以上の文字列の列の文字列を大文字に変換します。 </p></td><td colspan="1" rowspan="1"><p><code> UPPER(`Customers`) <a id="date_and_time" target="_blank" /></code></p></td></tr></tbody></table>

[このページのトップへ](#intro)

# 日付と時刻設定関数

<Note>
  **注記：** Beast Modeでは、 `WEEKDAY` 関数はサポートされていません。 `WEEKDAY` を使用する場合は、 `DAYOFWEEK` の機能に置き換えられます。
</Note>

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p> 関数 </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th><th colspan="1" rowspan="1"><p> 例 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><code> ADDDATE </code></p></td><td colspan="1" rowspan="1"><p> 日付列の日付の値に（間隔として）日付または日時の値を追加します。 </p><p> 日付列の日付の値に追加する日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えば <code> ADDDATE(`datecolumn`, interval expr unit ) </code> の場合、 <em> datecolumn </em> が日付の値を含む列であり、 <em> expr </em> が追加する日付または日時の値を含む引数で、 <em> unit </em> が対応する日付または日時の単位の種類の文字列です。 </p><p> 「-」を数式の冒頭に入力し、この数値を引くことができます。単位の数値（秒、分、時、日、週、月、四半期、年など）を指定できます（「間隔」のキーワードと、単位の値には大文字と小文字の区別はありません）。詳細については、「 <a href="/s/article/360043429953" target="_self" title="Beast Modeの日付形式の指定文字列"> Beast Modeの日付形式の指定文字列 </a> 」の「単位の値」セクションを参照してください。 </p><p> 例えば、 <code> 1月4日 </code> に12日を追加すると、 <code> 1月16日 </code> を返します。 </p><p><code> DATE\_ADD </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> ADDDATE(`DateCol`, interval 12 day) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> ADDTIME </code></p></td><td colspan="1" rowspan="1"><p> 時刻列内の値すべてに指定の秒数を追加します。例えば、 <code> 8:05 </code> に15秒を追加すると、 <code> 8:20 </code> を返します。 </p></td><td colspan="1" rowspan="1"><p><code> ADDTIME(`Time`,15) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> CURDATE </code></p></td><td colspan="1" rowspan="1"><p> 現在の日付を返します。 </p><p> この関数では列の名前は指定されていません。 </p><p><code> CURRENT\_DATE </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> CURDATE() </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> CURTIME </code></p></td><td colspan="1" rowspan="1"><p> 現在の時刻を返します。 </p><p> この関数では列の名前は指定されていません。 </p><p><code> CURRENT\_TIME </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> CURTIME() </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> CURRENT\_DATE </code></p></td><td colspan="1" rowspan="1"><p> 現在の日付を返します。 </p><p> この関数では列の名前は指定されていません。 </p><p><code> CURDATE </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> CURRENT\_DATE() </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> CURRENT\_TIME </code></p></td><td colspan="1" rowspan="1"><p> 現在の時刻を返します。 </p><p> この関数では列の名前は指定されていません。 </p><p><code> CURTIME </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> CURRENT\_TIME() </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> CURRENT\_TIMESTAMP </code></p></td><td colspan="1" rowspan="1"><p> 現在の日付と時間の値を <code> YYYY-MM-DD HH:MM:SS形式 </code> で返します。 </p><p> この関数では列の名前は指定されていません。 </p><p><code> NOW </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> CURRENT\_TIMESTAMP() </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE </code></p></td><td colspan="1" rowspan="1"><p> 日時の値から日付を抽出し、返します。 </p></td><td colspan="1" rowspan="1"><p><code> DATE(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATEDIFF </code></p></td><td colspan="1" rowspan="1"><p> 日時の値から2つの日付の間の日数を返します。 </p></td><td colspan="1" rowspan="1"><p><code> DATEDIFF(CURRENT\_DATE(), `lastmoddate`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_ADD </code></p></td><td colspan="1" rowspan="1"><p> 日付列の日付の値に（間隔として）日付または日時の値を追加します。 </p><p> 日付列の日付の値に追加する日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えば <code> DATE\_ADD(`datecolumn`, interval expr unit ) </code> の場合、 <em> datecolumn </em> が日付の値を含む列であり、 <em> expr </em> が追加する日付または日時の値を含む引数で、 <em> unit </em> が対応する日付または日時の単位の種類の文字列です。 </p><p> 「-」 を数式の冒頭に入力し、この数値を引くことができます。単位の数値（秒、分、時、日、週、月、四半期、年など）を指定できます（「間隔」のキーワードと、単位の値には大文字と小文字の区別はありません）。詳細については、「 <a href="/s/article/360043429953" target="_self" title="Beast Modeの日付形式の指定文字列"> Beast Modeの日付形式の指定文字列 </a> 」の「単位の値」セクションを参照してください。 </p><p> 例えば、 <code> 1月4日 </code> に12日を追加すると、 <code> 1月16日 </code> を返します。 </p><p><code> ADDDATE </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> DATE\_ADD(`DateCol`, interval 12 day) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列の日付を指定の形式に設定します。 </p><div class="mdx-embed"><Note><p><b> 注記： </b> Beast Modeでは、SQLと同じ日付と時刻の形式を使用します。 </p></Note></div><p> 日付列または時刻列に使用する書式を指定することができます。これは、列や日付または時刻の文字列を指定することで行います。例えば <code> DATE\_FORMAT(`datecolumn`,' format ') </code> の場合、 <em> datecolumn </em> は日付の値を含む列であり、 <em> format </em> は日付の値の書式に使用される指定子を含む文字列です。 </p><p> 「%」は指定文字列の前に使用する必要があります。 </p><p> 例えば、 <code> DATE\_FORMAT(`MyDate`,'%Y-%m-%d %h:%i %p') </code> を使用すると、 <em> MyDate </em> の日付列の日付は「2013-04-17 10:10 AM」の形式になります。 </p><p> 指定文字列の詳細に関しては、「 <a href="/s/article/360043429953" target="_self" title="Beast Modeの日付形式の指定文字列"> Beast Modeでの日付の形式指定文字列 </a> 」を参照してください。 </p><p><code> TIME\_FORMAT </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`DateCol`,'%y') </code><br /><code> DATE\_FORMAT(`DateCol`,'%m/%d') </code><br /><code> DATE\_FORMAT(NOW(),'%d %b %Y %T') </code><br /><code> DATE\_FORMAT(STR\_TO\_DATE(`DateCol`, '%m,%d,%Y'), '%m/%d/%Y') </code><br /><code> ADDDATE(DATE\_FORMAT(`DateCol`, '%Y-%m-%d'), interval 12 day) </code><br /><code> PERIOD\_DIFF(DATE\_FORMAT(CURDATE(), '%Y%m'), DATE\_FORMAT(`DateCol`, '%Y%m')) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_SUB </code></p></td><td colspan="1" rowspan="1"><p> 日付列内の日付の値から（間隔として）日付または日時の値を引きます。 </p><p> 日付列の日付の値に追加する日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えば <code> DATE\_SUB(`datecolumn`, interval expr unit ) </code> の場合、 <em> datecolumn </em> が日付の値を含む列であり、 <em> expr </em> が引く日付または日時の値を含む引数で、 <em> unit </em> が対応する日付または日時の単位の種類の文字列です。 </p><p> 「-」を数式の冒頭に入れてこの数値を足すことができます。単位の数値（秒、分、時、日、週、月、四半期、年など）を指定できます（「間隔」のキーワードと、単位の値には大文字と小文字の区別はありません）。詳細については、「 <a href="/s/article/360043429953" target="_self" title="Beast Modeの日付形式の指定文字列"> Beast Modeの日付形式の指定文字列 </a> 」の「単位の値」セクションを参照してください。 </p><p> 例えば、 <code> 1月24日 </code> から12日を引くと <code> 1月12日 </code> を返します。 </p><p><code> SUBDATE </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> DATE\_SUB(`DateCol`, interval 12 day) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DAY </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列のすべての値の月の日付を数値で返します。 </p><p><code> DAYOFMONTH </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> DAY(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DAYNAME </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列のすべての値の曜日名を返します。 </p></td><td colspan="1" rowspan="1"><p><code> DAYNAME(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DAYOFMONTH </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列のすべての値の月の日付を数値で返します。 </p><p><code> DAY </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> DAYOFMONTH(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DAYOFWEEK </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列のすべての値の曜日を数値で返します（例：「月曜日」の場合は「2」）。 </p></td><td colspan="1" rowspan="1"><p><code> DAYOFWEEK(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DAYOFYEAR </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列のすべての値を一年の何日目であるかの数値で返します（例：1年の226日目は「226」です）。 </p></td><td colspan="1" rowspan="1"><p><code> DAYOFYEAR(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> FROM\_DAYS </code></p></td><td colspan="1" rowspan="1"><p> 日付の数値を日付に変換します。 </p></td><td colspan="1" rowspan="1"><p><code> FROM\_DAYS(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><code> FROM\_UNIXTIME </code></td><td colspan="1" rowspan="1"><p> 指定された形式を使ってUNIXの日付/時刻列からUNIX日時の値を返します。 </p><p> 指定文字列の詳細に関しては、「 <a href="/s/article/360043429953" target="_self" title="Beast Modeの日付形式の指定文字列"> Beast Modeでの日付の形式指定文字列 </a> 」を参照してください。 </p></td><td colspan="1" rowspan="1"><p><code> FROM\_UNIXTIME(`UnixDateCol`,'%Y %d %m %h:%i:%s %x') </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> HOUR </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列内のすべての値の正時を返します（例：時刻が「3:36」の場合、「3」を返します）。 </p></td><td colspan="1" rowspan="1"><p><code> HOUR(`Time`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> LAST\_DAY </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列の各月の値を集計し、各月の最終日に集計した値を返します。 </p><p> 例えば、1月の日付/時刻の列に「15」、「16」、「17」があると、その最後の日付と3つの数字を足した48の数値のみが表示されます。 </p></td><td colspan="1" rowspan="1"><p><code> LAST\_DAY(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> MINUTE </code></p></td><td colspan="1" rowspan="1"><p> 時刻列内の各時刻（分）の値を返します。 </p><p> 列に特定の時刻（分）の例が1つ以上存在する場合は、該当する時刻（分）の値が集計されます。 </p></td><td colspan="1" rowspan="1"><p><code> MINUTE(`Time`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> MONTH </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列内のすべての値の月を数値で返します（例：9月の場合「9」）。 </p></td><td colspan="1" rowspan="1"><p><code> MONTH(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> MONTHNAME </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列内のすべての値の月の名前を返します（例：「9」ではなく「9月」）。 </p></td><td colspan="1" rowspan="1"><p><code> MONTHNAME(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> NOW </code></p></td><td colspan="1" rowspan="1"><p> 現在の日付と時間の値を <code> YYYY-MM-DD HH:MM:SS形式 </code> で返します。 </p><p> この関数では列の名前は指定されていません。 </p><p><code> CURRENT\_TIMESTAMP </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> NOW() </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> PERIOD\_ADD </code></p></td><td colspan="1" rowspan="1"><p> 日付列内の値に指定の月数を追加します。これが機能するには、日付の値は <code> YYYYMM </code> 形式での月になっている必要があります。 </p></td><td colspan="1" rowspan="1"><p><code> PERIOD\_ADD(`Month`,6) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> PERIOD\_DIFF </code></p></td><td colspan="1" rowspan="1"><p> 2つの日付列内の月の間の月数を返します。 </p><p> これが機能するには、日付の値は <code> YYYYMM </code> 形式での月になっている必要があります。例えば、1つの列に <code> 200803 </code> の日付値があり、ほかの列に <code> 200809 </code> の数値がある場合、この関数は6を返します。 </p></td><td colspan="1" rowspan="1"><p><code> PERIOD\_DIFF(201309,201301) </code><br /><code> PERIOD\_DIFF(`Month 1`, `Month 2`) </code><br /><code> PERIOD\_DIFF(DATE\_FORMAT(CURDATE(), '%Y%m'), DATE\_FORMAT(`DateCol`, '%Y%m')) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> QUARTER </code></p></td><td colspan="1" rowspan="1"><p> 日付の値データを四半期に集計します。 </p></td><td colspan="1" rowspan="1"><p><code> QUARTER(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> SECOND </code></p></td><td colspan="1" rowspan="1"><p> 時刻列の各時刻（秒）の値を返します。列内に特定の時刻（秒）の例が1つ以上存在する場合は、該当する時刻（秒）の値が集計されます。 </p></td><td colspan="1" rowspan="1"><p><code> SECOND(`Time`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> SEC\_TO\_TIME </code></p></td><td colspan="1" rowspan="1"><p> 秒を時間、分、秒に変換します。例えば、 <code> 3489秒 </code> は <code> 00:58:09 </code> に変換されます。 </p><div class="mdx-embed"><Note><p><b> 注： </b> sec\_to\_time関数は24時間に制限されています。値が24時間を超えると、オーバーフローし、0時間にループバックされます。 </p></Note></div></td><td colspan="1" rowspan="1"><p><code> SEC\_TO\_TIME(`Seconds`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> STR\_TO\_DATE </code></p></td><td colspan="1" rowspan="1"><p> 1つ以上の文字列の列の文字列（Domoが日付として認識しない文字列）を日時の値に変換します。列と現在列で使用されている日付の形式を指定してください。 </p><p> デフォルトとして、日時の数値は <code> %m-%d-%Y </code> の出力形式を返します。 <code> STR\_TO\_DATE </code> 計算を、使用したい日付の形式指定文字列を指定した <code> DATE\_FORMAT </code> 計算で囲むことにより、出力形式を変更することができます。 </p><p> 指定文字列の詳細に関しては、「 <a href="/s/article/360043429953" target="_self" title="Beast Modeの日付形式の指定文字列"> Beast Modeでの日付の形式指定文字列 </a> 」を参照してください。 </p></td><td colspan="1" rowspan="1"><p><code> STR\_TO\_DATE(`DateCol`,'%m,%d,%Y') </code><br /><code> DATE\_FORMAT(STR\_TO\_DATE(`DateCol`, '%m,%d,%Y'), '%m/%d/%Y') </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> SUBDATE </code></p></td><td colspan="1" rowspan="1"><p> 日付列内の日付の値から（間隔として）日付または日時の値を引きます。 </p><p> 日付列の日付の値から引く日付や日時の数値を指定することができます。これは、列や間隔、数式、単位を指定することで行います。例えば <code> SUBDATE(`datecolumn`, interval expr unit ) </code> の場合、 <em> datecolumn </em> が日付の値を含む列であり、 <em> expr </em> が引く日付または日時の値を含む引数で、 <em> unit </em> が対応する日付または日時の単位の種類の文字列です。 </p><p> 「-」を数式の冒頭に入れてこの数値を足すことができます。単位の数値（秒、分、時、日、週、月、四半期、年など）を指定できます（「間隔」のキーワードと、単位の値には大文字と小文字の区別はありません）。詳細については、「 <a href="/s/article/360043429953" target="_self" title="Beast Modeの日付形式の指定文字列"> Beast Modeの日付形式の指定文字列 </a> 」の「単位の値」セクションを参照してください。 </p><p> 例えば、 <code> 1月24日 </code> から12日を引くと <code> 1月12日 </code> を返します。 <code> DATE\_SUB </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> SUBDATE(`DateCol`, interval 12 day) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> SUBTIME </code></p></td><td colspan="1" rowspan="1"><p> 時刻列内の値すべてから指定の秒数を引きます。 </p><p> 例えば <code> 8:05:45 </code> から30秒を引くと、 <code> 8:05:15 </code> を返します。 </p></td><td colspan="1" rowspan="1"><p><code> SUBTIME(`Time`,30) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> SYSDATE </code></p></td><td colspan="1" rowspan="1"><p> 現在の日付と時刻をYYYY-MM-DD HH:MM:SS形式で返します（例： <code> 2014-04-03T19:25:29 </code> ）。 </p><p> この関数では列の名前は指定されていません。 </p><p><code> CURRENT\_DATE </code> や <code> CURRENT\_TIME </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> SYSDATE() </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> TIME </code></p></td><td colspan="1" rowspan="1"><p> 日時の値から時間を抽出します。 </p></td><td colspan="1" rowspan="1"><p><code> TIME(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> TIMEDIFF </code></p></td><td colspan="1" rowspan="1"><p> 2つの日付/時刻列内の値の差を時間の値として返します。 </p></td><td colspan="1" rowspan="1"><p><code> TIMEDIFF(`Time 1`,`Time 2`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> TIMESTAMP </code></p></td><td colspan="1" rowspan="1"><p> 日付列の値を日時の値として返します。 </p></td><td colspan="1" rowspan="1"><p><code> TIMESTAMP(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> TIME\_FORMAT </code></p></td><td colspan="1" rowspan="1"><p> 日時列の時間を指定の形式に設定します。 </p><div class="mdx-embed"><Note><p><b> 注記： </b> Beast Modeでは、SQLと同じ日付と時刻の形式を使用します。 </p></Note></div><p> 列や時間の文字列を指定することにより、時間列の時間値に使用する形式を指定することができます。 <code> TIME\_FORMAT(`datetimecolumn`,' format ') </code> の場合、 <em> datetimecolumn </em> は時間の値を含む列であり、 <em> format </em> が時間値の書式設定に使用される指定子を含む文字列です。 </p><div class="mdx-embed"><Note><p><b> 注記： </b><code> DATE\_FORMAT </code> で使用される形式の指定子は <code> TIME\_FORMAT </code> と併用できますが、時、分、秒、マイクロ秒以外の指定子は、NULL値または0を生成します。 </p></Note></div><p> 「%」は指定文字列の前に使用する必要があります。 </p><p> 例えば、 <code> TIME\_FORMAT(`Date`,'%h:%i:%s') </code> を使うと、変換済みの時間列の日付はこの形式になります：12:20:12 </p><p> 指定文字列について詳しくは、「 <a class="confluence-link" href="/s/article/360043429953" target="_self"> Beast Modeでの日付の形式指定文字列 </a> 」を参照してください。 </p><p><code> DATE\_FORMAT </code> と同じです。 </p></td><td colspan="1" rowspan="1"><p><code> TIME\_FORMAT(`Date`,'%h:%i:%s') </code><br /><code> TIME\_FORMAT(NOW(),'%h:%i:%s') </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> TIME\_TO\_SEC </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列のすべての値の経過時間（秒）を返します。 </p></td><td colspan="1" rowspan="1"><p><code> TIME\_TO\_SEC(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> TO\_DAYS </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列のすべての値の0年からの日数を返します。例えば、日付「01-06-2010」は、0年1月1日からこの日付までに734,143日間経過しているため、「734143」が返されます。 </p></td><td colspan="1" rowspan="1"><p><code> TO\_DAYS(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><code> UNIX\_TIMESTAMP </code></td><td colspan="1" rowspan="1"> 日付/時刻列のすべての値のUNIXタイムスタンプを返します。 </td><td colspan="1" rowspan="1"><code> UNIX\_TIMESTAMP(`DateCol`) </code></td></tr><tr><td colspan="1" rowspan="1"><code> WEEK </code></td><td colspan="1" rowspan="1"><p> 指定された日付または日時列の各値の週の番号を返します。 </p><p> 構文： <code> WEEK(`dateCol`, mode) </code> 。 </p><p> 日～土の週フレームの場合、モード11を使用します（例： <code> WEEK(`dateCol`, 11) </code> ）。 </p><p> 月～日の週フレームの場合、モード22を使用します（例： <code> WEEK(`dateCol`, 22) </code> ）。 </p></td><td colspan="1" rowspan="1"><code> WEEK(`DateCol`,22) </code></td></tr><tr><td colspan="1" rowspan="1"><p><code> YEAR </code></p></td><td colspan="1" rowspan="1"><p> 日付/時刻列の値すべての年を返します。 </p></td><td colspan="1" rowspan="1"><p><code> YEAR(`DateCol`) </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> YEARWEEK </code></p></td><td colspan="1" rowspan="1"><p> 指定された日付または日時列の各値の週の番号を、「YYYYWW」の形式で返します。例えば、2020年の第5週の日付であれば、「202005」が返されます。 </p><p> 構文： <code> YEARWEEK(`dateCol`, mode) </code></p><p> 日～土の週フレームの場合、モード11を使用します（例： <code> YEARWEEK(`dateCol`, 11) </code> ）。 </p><p> 月～日の週フレームの場合、モード22を使用します（例： <code> YEARWEEK(`dateCol`, 22) </code> ）。 </p></td><td colspan="1" rowspan="1"><p><code> YEARWEEK(`DateCol`,11) </code></p></td></tr></tbody></table>

[このページのトップへ](#intro)

### 計算をまとめ数字に適用する

DataSet内でBeast Mode計算が行を集計する場合、カードのまとめ数字に使用できます。以下のいずれかの関数を使用して作成された計算は、まとめ数字に適用できます。

* ```AVG theme={"dark"}

  COUNT

  COUNT (DISTINCT)

  MAX

  MIN

  SUM

  SUM (DISTINCT)

  STDDEV_POP、VAR_POP
  ```

これらの関数のいずれかを追加すると、このカードのまとめ数字で使用される利用可能な列のリストにBeast Mode計算が自動的に追加されます。

<Note>
  **注記：**
  Beast Mode計算がまとめ数字として機能するには、何らかの手段で集計されているか（例：
  `SUM()`
  関数）または、関数内で数値に行われた演算の結果である必要があります（例：
  `SUM()`
  関数）。例えば、
  `'Customers'`
  はまとめ数字として使えませんが、
  `SUM('Customers')`
  はまとめ数字として使うことができます。
</Note>

まとめ数字の詳細については、「
[チャートのまとめ数字を設定する](/s/article/360043428753 "チャートのまとめ数字を設定する")
」を参照してください。

### サポートされていない関数

`SQRT`
、
`CONVERT_TZ`
、
`MICROSECOND`
、
`WEEKDAY`
の各関数は、サポートが終了しています。

[このページのトップへ](#intro)

日本語
