> ## 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の日付形式の指定文字列

## はじめに

`DATE_FORMAT` 関数を使用するBeast Mode計算では、列と日付、または時間の文字列を指定することによって、日付または時間の列に使用する書式を指定できます。つまり ``DATE_FORMAT(` datecolumn `,' format ')`` のようにします。ここでは、 *datecolumn* は日付の数値を含む列となり、 *format* は日付数値の形式設定指定子を含む文字列となります。

例えば、 ``DATE_FORMAT(`MyDate`,'%Y-%m-%d %h:%i %p')`` を使用すると、 *MyDate* の日付列の日付は「2013-04-17 10:10 AM」の形式になります。

「%」は指定文字列の前に使用する必要があります。

必要に応じて、 `STR_TO_DATE` 関数を使って、列内の日付文字列の値を日時数値に変換できます。

<Note>
  **注記：** `TIME_FORMAT` 関数を使用するBeast Mode計算では、列および時間の文字列を指定することによって、時間の列に使用する書式を指定できます。つまり ``TIME_FORMAT(` datetimecolumn `,' format ')`` のようにします。ここでは、 *datetimecolumn* は時間の数値を含む列となり、 *format* は時間数値の形式設定指定子を含む文字列となります。

  `DATE_FORMAT` で使用される形式指定子は `TIME_FORMAT` と併用できますが、時間、分、秒、マイクロ秒以外の指定子では、NULL値または0が生成されます。
</Note>

**形式の例**

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:203;a"><thead><tr><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> DATE\_FORMAT(`MyDateColumn`,'%m-%d-%Y') </code></p></td><td colspan="1" rowspan="1"><p><code> 11-04-2008 </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDateColumn`,'%d %b %y') </code></p></td><td colspan="1" rowspan="1"><p><code> 04 Nov 08 </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDateColumn`,'%d %b %Y %T') </code></p></td><td colspan="1" rowspan="1"><p><code> 04 Nov 2008 11:45:34 </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDateColumn`, '%m/%d/%Y') </code></p></td><td colspan="1" rowspan="1"><p><code> 01/13/2013 </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDateColumn`, '%M %d, %Y') </code></p></td><td colspan="1" rowspan="1"><p><code> August 1, 2013 </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDateColumn`, '%b %d, %Y') </code></p></td><td colspan="1" rowspan="1"><p><code> Aug 1, 2013 </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDateColumn`,'%b %d %Y %h:%i %p') </code></p></td><td colspan="1" rowspan="1"><p><code> Nov 04 2008 11:45 PM </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDateColumn`,'%Y-%m-%d %h:%i:%s') </code></p></td><td colspan="1" rowspan="1"><p><code> 2013-11-06 09:38:10 </code></p></td></tr><tr><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(STR\_TO\_DATE(`MyDateColumn`,'%m,%d,%Y'),'%m/%d/%Y') </code></p></td><td colspan="1" rowspan="1"><p><code> 11/04/2008 </code></p></td></tr></tbody></table>

Beast Mode計算を追加する方法の詳細については「 [Beast Mode計算をチャートに追加する](/s/article/360043429913 "Beast Mode計算をチャートに追加する") 」を参照してください。

## 日付の形式指定子

すべての例で日時は2013年4月15日午後11:44:15とします。

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:203;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><th colspan="1" rowspan="1"><p> 結果 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><code> %a </code></p></td><td colspan="1" rowspan="1"><p> 曜日の英略語表示（Sun..Sat） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%a') </code></p></td><td colspan="1" rowspan="1"><p> Mon </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %b </code></p></td><td colspan="1" rowspan="1"><p> 月の英略語表記（Jan..Dec） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%b') </code></p></td><td colspan="1" rowspan="1"><p> Apr </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %d </code></p></td><td colspan="1" rowspan="1"><p> 日、数字表記（00～31） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%d') </code></p></td><td colspan="1" rowspan="1"><p> 13 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %f </code></p></td><td colspan="1" rowspan="1"><p> マイクロ秒（000000～999999） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%f') </code></p></td><td colspan="1" rowspan="1"><p> 300000 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %H </code></p></td><td colspan="1" rowspan="1"><p> 時（00～23） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%H') </code></p></td><td colspan="1" rowspan="1"><p> 23 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %h </code></p></td><td colspan="1" rowspan="1"><p> 時（01～12） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%h') </code></p></td><td colspan="1" rowspan="1"><p> 11 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %i </code></p></td><td colspan="1" rowspan="1"><p> 分、数字表記（00～59） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%i') </code></p></td><td colspan="1" rowspan="1"><p> 44 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %j </code></p></td><td colspan="1" rowspan="1"><p> 年の通算日表記（001～366） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`, '%j') </code></p></td><td colspan="1" rowspan="1"><p> 105 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %M </code></p></td><td colspan="1" rowspan="1"><p> 月の英語名（January..December） </p><div class="mdx-embed"><Note><p><b> 注記： </b> このオプションでは、9文字になるように末尾が空白文字でパディングされます。 </p></Note></div></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%M') </code></p></td><td colspan="1" rowspan="1"><p> April </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %m </code></p></td><td colspan="1" rowspan="1"><p> 月、数字表記（00～12） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%m') </code></p></td><td colspan="1" rowspan="1"><p> 04 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %p </code></p></td><td colspan="1" rowspan="1"><p> AMまたはPM </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%p') </code></p></td><td colspan="1" rowspan="1"><p> PM </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %r </code></p></td><td colspan="1" rowspan="1"><p> 時間、12時間制（hh:mm:ssにAMまたはPMが後続） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%r') </code></p></td><td colspan="1" rowspan="1"><p> 11:44:15 PM </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %s </code></p></td><td colspan="1" rowspan="1"><p> 秒（00～59） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%s') </code></p></td><td colspan="1" rowspan="1"><p> 15 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %T </code></p></td><td colspan="1" rowspan="1"><p> 時間、24時間制（hh:mm:ss） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%T') </code></p></td><td colspan="1" rowspan="1"><p> 23:44:15 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %v </code></p></td><td colspan="1" rowspan="1"><p> ISOの年間週数（新年の最初の木曜日は第1週） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'v') </code></p></td><td colspan="1" rowspan="1"><p> 16 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %W </code></p></td><td colspan="1" rowspan="1"><p> 曜日の英語名（Sunday..Saturday） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%W') </code></p></td><td colspan="1" rowspan="1"><p> 月曜日 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %w </code></p></td><td colspan="1" rowspan="1"><p> 曜日（1～7。日曜日が1） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'w') </code></p></td><td colspan="1" rowspan="1"><p> 2 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %x </code></p></td><td colspan="1" rowspan="1"><p> ISOの年（4桁以上） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'x') </code></p></td><td colspan="1" rowspan="1"><p> 2013 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %Y </code></p></td><td colspan="1" rowspan="1"><p> 年（4桁以上） </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%Y') </code></p></td><td colspan="1" rowspan="1"><p> 2013 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %y </code></p></td><td colspan="1" rowspan="1"><p> 年の末尾2桁 </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%y') </code></p></td><td colspan="1" rowspan="1"><p> 13 </p></td></tr></tbody></table>

## 単位の値

日付や日時表現など単位の値は、 `ADDDATE` 、 `DATE_ADD` 、 `DATE_SUB` 、 `SUBDATE` 関数を使用して指定できます。その中には以下が含まれます。

<Note>
  **注記：** Beast Mode計算では、単位の種類の値には大文字と小文字の区別はありません。
</Note>

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:203;a"><thead><tr><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> MICROSECOND </p></td><td colspan="1" rowspan="1"><p> MICROSECONDS </p></td></tr><tr><td colspan="1" rowspan="1"><p> SECOND </p></td><td colspan="1" rowspan="1"><p> SECONDS </p></td></tr><tr><td colspan="1" rowspan="1"><p> MINUTE </p></td><td colspan="1" rowspan="1"><p> MINUTES </p></td></tr><tr><td colspan="1" rowspan="1"><p> HOUR </p></td><td colspan="1" rowspan="1"><p> HOURS </p></td></tr><tr><td colspan="1" rowspan="1"><p> DAY </p></td><td colspan="1" rowspan="1"><p> DAYS </p></td></tr><tr><td colspan="1" rowspan="1"><p> WEEK </p></td><td colspan="1" rowspan="1"><p> WEEKS </p></td></tr><tr><td colspan="1" rowspan="1"><p> MONTH </p></td><td colspan="1" rowspan="1"><p> MONTHS </p></td></tr><tr><td colspan="1" rowspan="1"><p> QUARTER </p></td><td colspan="1" rowspan="1"><p> QUARTERS </p></td></tr><tr><td colspan="1" rowspan="1"><p> YEAR </p></td><td colspan="1" rowspan="1"><p> YEARS </p></td></tr><tr><td colspan="1" rowspan="1"><p> SECOND\_MICROSECOND </p></td><td colspan="1" rowspan="1"><p> 'SECONDS.MICROSECONDS' </p></td></tr><tr><td colspan="1" rowspan="1"><p> MINUTE\_MICROSECOND </p></td><td colspan="1" rowspan="1"><p> 'MINUTES:SECONDS.MICROSECONDS' </p></td></tr><tr><td colspan="1" rowspan="1"><p> MINUTE\_SECOND </p></td><td colspan="1" rowspan="1"><p> 'MINUTES:SECONDS' </p></td></tr><tr><td colspan="1" rowspan="1"><p> HOUR\_MICROSECOND </p></td><td colspan="1" rowspan="1"><p> 'HOURS:MINUTES:SECONDS.MICROSECONDS' </p></td></tr><tr><td colspan="1" rowspan="1"><p> HOUR\_SECOND </p></td><td colspan="1" rowspan="1"><p> 'HOURS:MINUTES:SECONDS' </p></td></tr><tr><td colspan="1" rowspan="1"><p> HOUR\_MINUTE </p></td><td colspan="1" rowspan="1"><p> 'HOURS:MINUTES' </p></td></tr><tr><td colspan="1" rowspan="1"><p> DAY\_MICROSECOND </p></td><td colspan="1" rowspan="1"><p> 'DAYS HOURS:MINUTES:SECONDS.MICROSECONDS' </p></td></tr><tr><td colspan="1" rowspan="1"><p> DAY\_SECOND </p></td><td colspan="1" rowspan="1"><p> 'DAYS HOURS:MINUTES:SECONDS' </p></td></tr><tr><td colspan="1" rowspan="1"><p> DAY\_MINUTE </p></td><td colspan="1" rowspan="1"><p> 'DAYS HOURS:MINUTES' </p></td></tr><tr><td colspan="1" rowspan="1"><p> DAY\_HOUR </p></td><td colspan="1" rowspan="1"><p> 'DAYS HOURS' </p></td></tr><tr><td colspan="1" rowspan="1"><p> YEAR\_MONTH </p></td><td colspan="1" rowspan="1"><p> 'YEARS-MONTHS' </p></td></tr></tbody></table>

日本語
