TO_YYYYMM

Extracts the year and month from a DATE, TIMESTAMP, or TIMESTAMPTZ value and combines them into an integer beginning with the four-digit year followed by the two-digit month. TO_YYYYMM(<expression>) is equivalent to EXTRACT(YEAR FROM <expression>) * 100 + EXTRACT(MONTH FROM <expression>);

Syntax

TO_YYYYMM(<expression>)

Parameters

Parameter Description Supported input types
<expression> The expression from which the time units are extracted. DATE, TIMESTAMP, TIMESTAMPTZ

TIMESTAMPTZ values are converted to local time according to the session’s time_zone setting before extracting the time units.

Return Types

INT

Remarks

The TO_YYYYMM function can be used in the PARTITION BY clause of CREATE TABLE commands.

CREATE TABLE test (
  t TIMESTAMP
)
PARTITION BY TO_YYYYMM(t);

Example

Interactive SQL Playground 🔥
SELECT TO_YYYYMM('2025-04-03') as yyyymm, TO_YYYYMMDD('2025-04-03') as yyyymmdd;
Interactive SQL Playground 🔥
SELECT TO_YYYYMM('1920-12-30') as yyyymm, TO_YYYYMMDD('1920-12-30') as yyyymmdd;