Function Reference

EXTRACT

Extracts the given part from a date or time.

MySQL 8.1
EXTRACT(unit FROM date)

Parameters

unitkeyword
Part of the date or time to extract
Values:MICROSECONDSECONDMINUTEHOURDAYWEEKMONTHQUARTERYEARSECOND_MICROSECONDMINUTE_MICROSECONDMINUTE_SECONDHOUR_MICROSECONDHOUR_SECONDHOUR_MINUTEDAY_MICROSECONDDAY_SECONDDAY_MINUTEDAY_HOURYEAR_MONTH
dateDATETIME
Date, time or datetime

Return value

An integer; parts of a compound unit are joined: YEAR_MONTH for 2024-03-08 gives 202403

Examples

Month from a date and time

MySQL 8.1
SELECT EXTRACT(
		MONTH
		FROM '2024-03-08 14:30:00'
	);
EXTRACT(MONTH FROM '2024-03-08 14:30:00')
3

Birth year from a table

MySQL 8.1
SELECT member_name,
	EXTRACT(
		YEAR
		FROM birthday
	) AS birth_year
FROM FamilyMembers;
member_namebirth_year
Headley Quincey1960
Flavia Quincey1963
Andie Quincey1983
Lela Quincey1985
Annie Quincey1988
Ernest Forrest1961
Constance Forrest1968
Wednesday Addams2005

Compound unit HOUR_MINUTE

MySQL 8.1
SELECT EXTRACT(
		HOUR_MINUTE
		FROM '2024-03-08 14:30:00'
	) AS hhmm;
hhmm
1430

Details

EXTRACT is standard SQL syntax: unlike YEAR, MONTH and other separate functions, it also exists in PostgreSQL, but without compound units.

See also