DATE_FORMAT function in MySQL - Step-by-Step Execution

Concept Flow - DATE_FORMAT function

Input: Date/Datetime

↓

Apply DATE_FORMAT with format string

↓

Parse format specifiers

↓

Replace specifiers with date parts

↓

Return formatted string

The DATE_FORMAT function takes a date or datetime and a format string, then replaces format codes with parts of the date to produce a formatted text.

Execution Sample

MySQL

SELECT DATE_FORMAT('2024-06-15 14:30:45', '%Y-%m-%d %H:%i:%s');

Formats the given datetime into 'Year-Month-Day Hour:Minute:Second' text.

Execution Table

Step	Format Specifier	Date Part Extracted	Replacement Text	Intermediate Result
1	%Y	Year (2024)	2024	2024
2	%m	Month (06)	06	2024-06
3	%d	Day (15)	15	2024-06-15
4	%H	Hour (14)	14	2024-06-15 14
5	%i	Minute (30)	30	2024-06-15 14:30
6	%s	Second (45)	45	2024-06-15 14:30:45
7	No more specifiers	N/A	N/A	2024-06-15 14:30:45

💡 All format specifiers replaced, final formatted string returned.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	After Step 5	After Step 6	Final
formatted_string	''	'2024'	'2024-06'	'2024-06-15'	'2024-06-15 14'	'2024-06-15 14:30'	'2024-06-15 14:30:45'	'2024-06-15 14:30:45'

Key Moments - 3 Insights

Why does the output show '06' for the month instead of '6'?

Because the format specifier '%m' always returns the month as two digits with a leading zero if needed, as shown in execution_table step 2.

What happens if the format string has text without % specifiers?

That text is included as-is in the output. Only parts starting with % are replaced, so normal characters remain unchanged.

Why is the final output a string and not a date type?

DATE_FORMAT returns a formatted text string, not a date type, because it converts date parts into readable text as shown in the final step of execution_table.

Visual Quiz - 3 Questions

Look at the execution_table, what is the intermediate result after replacing '%d'?

A 2024-06-15 14

B 2024-06

C 2024-06-15

D 2024

💡 Hint

Check the intermediate result column at step 3 where '%d' is replaced.

At which step does the formatted string include the hour part?

A Step 4

B Step 3

C Step 5

D Step 6

💡 Hint

Look at the format specifier column and see when '%H' is replaced.

If the format string was '%Y/%m/%d', what would be the output after step 2?

A 2024-06

B 2024/06

C 2024/06/15

D 2024-06-15

💡 Hint

Refer to how separators in the format string appear in the intermediate result in execution_table.

Concept Snapshot

DATE_FORMAT(date, format) returns a string formatted from date.
Use %Y for 4-digit year, %m for 2-digit month, %d for day.
Other codes: %H hour, %i minute, %s second.
Non-% text is copied as-is.
Output is always text, not date type.

Full Transcript

The DATE_FORMAT function in MySQL takes a date or datetime value and a format string. It reads the format string from left to right, replacing each format specifier like %Y, %m, %d with the corresponding part of the date. For example, %Y becomes the 4-digit year, %m the 2-digit month with leading zero, and so on. Text in the format string that is not a specifier is included unchanged. The function returns the final formatted string. This process is stepwise: each specifier is replaced in order, building the output string. The output is always a text string, not a date type. This helps display dates in readable or custom formats.

Practice

1. What does the MySQL function DATE_FORMAT(date, format) do?

easy

A. It calculates the difference between two dates.

B. It converts a string to a date type.

C. It adds days to a date value.

D. It changes how a date or time is displayed using a specific pattern.

Solution

1. Step 1: Understand the function purpose

   The DATE_FORMAT function is used to display dates in a specific format by applying a pattern string.

2. Step 2: Compare options with function behavior

   Only It changes how a date or time is displayed using a specific pattern. correctly describes changing the display format of a date/time value.

3. Final Answer:

   It changes how a date or time is displayed using a specific pattern. -> Option D

4. Quick Check:

   DATE_FORMAT changes display format = A [OK]

Hint: DATE_FORMAT changes date display style, not date value [OK]

Common Mistakes:

• Confusing DATE_FORMAT with date arithmetic functions
• Thinking it converts strings to dates
• Assuming it calculates date differences

2. Which of the following is the correct syntax to format a date as 'Year-Month-Day' using DATE_FORMAT?

easy

A. DATE_FORMAT(date, '%Y-%m-%d')

B. DATE_FORMAT(date, 'YYYY-MM-DD')

C. DATE_FORMAT(date, '%y/%M/%d')

D. DATE_FORMAT(date, 'YY-MM-DD')

Solution

1. Step 1: Recall correct format specifiers

   In MySQL, '%Y' is 4-digit year, '%m' is 2-digit month, '%d' is 2-digit day.

2. Step 2: Check each option's format string

   Only DATE_FORMAT(date, '%Y-%m-%d') uses correct MySQL format specifiers and separators for 'Year-Month-Day'. Others use invalid or wrong specifiers.

3. Final Answer:

   DATE_FORMAT(date, '%Y-%m-%d') -> Option A

4. Quick Check:

   Use %Y-%m-%d for year-month-day [OK]

Hint: Use %Y for year, %m for month, %d for day in DATE_FORMAT [OK]

Common Mistakes:

• Using uppercase YYYY instead of %Y
• Mixing format codes from other languages
• Using wrong separators like slashes instead of dashes

3. Given the query:
SELECT DATE_FORMAT('2024-06-15 14:30:00', '%W, %M %d, %Y %r') AS formatted_date;
What is the expected output in the formatted_date column?

medium

A. Sun, Jun 15, 2024 02:30 PM

B. Saturday, June 15, 2024 02:30:00 PM

C. Saturday, June 15, 2024 14:30:00

D. 2024-06-15 14:30:00

Solution

1. Step 1: Understand each format specifier

   %W = full weekday name (Saturday), %M = full month name (June), %d = day (15), %Y = year (2024), %r = 12-hour time with seconds and AM/PM (02:30:00 PM).

2. Step 2: Apply format to given datetime

   The datetime '2024-06-15 14:30:00' is 2:30 PM in 12-hour format, so output matches Saturday, June 15, 2024 02:30:00 PM exactly.

3. Final Answer:

   Saturday, June 15, 2024 02:30:00 PM -> Option B

4. Quick Check:

   Full weekday, month, and 12-hour time = C [OK]

Hint: Remember %r gives 12-hour time with seconds and AM/PM [OK]

Common Mistakes:

• Confusing %r with 24-hour time %H:%i:%s
• Using abbreviated weekday (%a) instead of full (%W)
• Ignoring AM/PM in output

4. Identify the error in this query:
SELECT DATE_FORMAT('2024-06-15', '%Y-%m-%d %H:%i:%s') AS formatted_date;
What will happen when this query runs?

medium

A. It will return NULL because the input has no time part.

B. It will cause a syntax error due to wrong format specifiers.

C. It will return '2024-06-15 00:00:00' as the time defaults to midnight.

D. It will return only the date part ignoring the time format.

Solution

1. Step 1: Analyze input and format

   The input date '2024-06-15' has no time, but MySQL treats missing time as '00:00:00'. Format includes time specifiers %H:%i:%s.

2. Step 2: Predict output behavior

   MySQL fills missing time with zeros, so output will be '2024-06-15 00:00:00'. No syntax error occurs.

3. Final Answer:

   It will return '2024-06-15 00:00:00' as the time defaults to midnight. -> Option C

4. Quick Check:

   Missing time defaults to 00:00:00 in DATE_FORMAT [OK]

Hint: Missing time defaults to 00:00:00, no error [OK]

Common Mistakes:

• Expecting syntax error for valid format
• Assuming NULL output for missing time
• Ignoring default midnight time fill

5. You want to display a datetime column created_at as 'Day-Month-Year Hour:Minute AM/PM' in a report. Which DATE_FORMAT pattern correctly formats it as '15-Jun-2024 02:30 PM'?

hard

A. DATE_FORMAT(created_at, '%d-%b-%Y %h:%i %p')

B. DATE_FORMAT(created_at, '%d-%m-%Y %H:%i %p')

C. DATE_FORMAT(created_at, '%d-%M-%Y %h:%i %P')

D. DATE_FORMAT(created_at, '%d-%b-%Y %H:%i %p')

Solution

1. Step 1: Match each format code to desired output

   %d = day with leading zero (15), %b = abbreviated month name (Jun), %Y = 4-digit year (2024), %h = 12-hour hour (02), %i = minutes (30), %p = AM/PM uppercase.

2. Step 2: Check options for correct codes and case

   DATE_FORMAT(created_at, '%d-%b-%Y %h:%i %p') matches all codes correctly. DATE_FORMAT(created_at, '%d-%m-%Y %H:%i %p') uses %m (numeric month) instead of %b. DATE_FORMAT(created_at, '%d-%M-%Y %h:%i %P') uses %M (full month) and %P (invalid). DATE_FORMAT(created_at, '%d-%b-%Y %H:%i %p') uses %H (24-hour) instead of %h.

3. Final Answer:

   DATE_FORMAT(created_at, '%d-%b-%Y %h:%i %p') -> Option A

4. Quick Check:

   Use %b for short month, %h for 12-hour, %p for AM/PM [OK]

Hint: Use %b for short month, %h for 12-hour, %p for AM/PM [OK]

Common Mistakes:

• Using %m instead of %b for month name
• Using %H (24-hour) instead of %h (12-hour)
• Using %P which is invalid in MySQL