> ## 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.

# Date Format Specifier Characters for Beast Mode

## Intro

In a Beast Mode calculation using a `DATE_FORMAT` function, you can specify the format to use for a date or time column by specifying the column and the date or time string, as in ``DATE_FORMAT(`datecolumn`,`format ` )`` where `datecolumn` is the column containing a date value and where `format` is the string containing specifier characters to use in formatting the date value.

For example, using ``DATE_FORMAT(`MyDate`,'%Y-%m-%d %h:%i %p')``, the date in the `MyDate` date column uses this format: 2013-04-17 10:10 AM.

The "%" character is required before format specifier characters.

If necessary, you can convert date string values in columns to datetime values using the `STR_TO_DATE` function.

<Note>
  **Note:** In a Beast Mode calculation using a `TIME_FORMAT` function, you can specify the format to use for time values in a time column by specifying the column and the time string, as in ``TIME_FORMAT(` datetimecolumn `,' format ')`` where *datetimecolumn* is the column containing a time value and where *format* is the string containing specifier characters to use in formatting the time value.

  The format specifiers used in `DATE_FORMAT` may be used with `TIME_FORMAT`, but specifiers other than hours, minutes, seconds and microseconds produce a NULL value or 0.
</Note>

**Sample Formats**

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:209;a"><thead><tr><th colspan="1" rowspan="1"><p> Format </p></th><th colspan="1" rowspan="1"><p> Result </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>

For more information about adding Beast Mode calculations, see [Create a Beast Mode Calculation](/s/article/360043429913).

## Date Format Specifiers

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:209;a"><thead><tr><th colspan="1" rowspan="1"><p> Specifier </p></th><th colspan="1" rowspan="1"><p> Description </p></th><th colspan="1" rowspan="1"><p> Sample </p></th><th colspan="1" rowspan="1"><p> Result </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><code> %a </code></p></td><td colspan="1" rowspan="1"><p> Abbreviated weekday name (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> Abbreviated month name (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"><code> %c </code></td><td colspan="1" rowspan="1"> Numeric month without preceding zero </td><td colspan="1" rowspan="1"><code> DATE\_FORMAT(`MyDate`,'%c') </code></td><td colspan="1" rowspan="1"> 4 </td></tr><tr><td colspan="1" rowspan="1"><p><code> %d </code></p></td><td colspan="1" rowspan="1"><p> Numeric day of month with preceding zero </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%d') </code></p></td><td colspan="1" rowspan="1"><p> 05 </p></td></tr><tr><td colspan="1" rowspan="1"><code> %e </code></td><td colspan="1" rowspan="1"> Numeric day of month without preceding zero </td><td colspan="1" rowspan="1"><code> DATE\_FORMAT(`MyDate`,'%e') </code></td><td colspan="1" rowspan="1"> 5 </td></tr><tr><td colspan="1" rowspan="1"><p><code> %f </code></p></td><td colspan="1" rowspan="1"><p> Microseconds (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> Hour (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> Hour (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> Minutes, numeric (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> Day of year (001-366) </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`, '%j') </code></p></td><td colspan="1" rowspan="1"><p> 95 </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %M </code></p></td><td colspan="1" rowspan="1"><p> Month name (January..December) </p><div class="mdx-embed"><Note><p><b> Note: </b> This option is padded with trailing whitespace to 9 characters. </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> Month, numeric (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 or 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> Time, 12-hour (hh:mm:ss followed by AM or 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> Seconds (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> Time, 24-hour (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 week number of the year (the first Thursday of the new year is in week 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> Weekday name (Sunday..Saturday) </p></td><td colspan="1" rowspan="1"><p><code> DATE\_FORMAT(`MyDate`,'%W') </code></p></td><td colspan="1" rowspan="1"><p> Monday </p></td></tr><tr><td colspan="1" rowspan="1"><p><code> %w </code></p></td><td colspan="1" rowspan="1"><p> Day of the week (1-7; Sunday is 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 year (4 or more digits) </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> Year (4 or more digits) </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> Last two digits of year </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>

## Unit Type Values

You can specify unit type values for date or datetime expressions in `ADDDATE`, `DATE_ADD`, `DATE_SUB`, and `SUBDATE` functions, including those listed in the following table.

<Note>
  **Note:** In Beast Mode calculations, the unit type value is case insensitive.
</Note>

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:209;a"><thead><tr><th colspan="1" rowspan="1"><p> Unit Type Value </p></th><th colspan="1" rowspan="1"><p> Expected Expression Format </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>
