Nivel 3 · Ingresos mensuales de 2025

“Ingresos por mes” quizá sea la consulta de analista más común. El truco es convertir cada timestamp en una clave de mes y luego agrupar por ella.

DATE_TRUNC

DATE_TRUNC('month', ts) redondea un timestamp hacia abajo hasta el inicio de su mes: 2025-03-18 14:22:05 se convierte en 2025-03-01 00:00:00. Todo pedido de marzo se asigna al mismo valor, así que agrupar por él da una fila por mes.

SELECT
  CAST(DATE_TRUNC('month', order_date) AS DATE) AS month,
  COUNT(*) AS orders
FROM orders
GROUP BY 1
ORDER BY 1;

Otras unidades funcionan igual: 'day', 'week' (las semanas empiezan el lunes en Postgres y DuckDB), 'quarter', 'year'.

En DuckDB y Postgres, truncar un timestamp devuelve un timestamp. El CAST(... AS DATE) convierte el resultado en una fecha limpia, que queda mejor en gráficos y hojas de cálculo.

¿Por qué no EXTRACT(MONTH …)?

EXTRACT(MONTH FROM order_date) devuelve de 1 a 12. Si agrupas por eso en tres años de datos, marzo de 2023, 2024 y 2025 quedan juntos en una fila. DATE_TRUNC conserva el año, así que es la clave correcta para una serie de tiempo. Usa EXTRACT (o DATE_PART) para preguntas de estacionalidad como “¿qué mes del año es el más ocupado?”.

Dialectos

base de datos	clave de mes
DuckDB, Postgres, Snowflake	DATE_TRUNC('month', order_date)
BigQuery	DATE_TRUNC(order_date, MONTH) (o TIMESTAMP_TRUNC para timestamps)
MySQL	DATE_FORMAT(order_date, '%Y-%m-01'), o DATE_SUB(DATE(order_date), INTERVAL DAY(order_date) - 1 DAY)
SQL Server	DATETRUNC(month, order_date) (2022+) o DATEFROMPARTS(YEAR(d), MONTH(d), 1)

Ponerlo todo junto

Los ingresos necesitan las líneas, el estado necesita el pedido. Tras el join, el grano son las líneas de pedido, así que cuenta pedidos con COUNT(DISTINCT o.order_id) (recuerda el fan-out del capítulo 5). Filtra el año con un rango semiabierto sobre la columna original, no sobre la truncada, para que la base de datos pueda saltarse datos de forma eficiente.

Meses faltantes

Si un mes no tuvo pedidos completados, simplemente no aparecería. Para un gráfico, un mes faltante es engañoso: la línea salta directamente de febrero a abril. Genera un calendario y haz LEFT JOIN sobre él:

SELECT CAST(m AS DATE) AS month
FROM generate_series(DATE '2025-01-01', DATE '2025-12-01', INTERVAL 1 MONTH) AS t(m);

generate_series existe en Postgres y DuckDB. BigQuery usa GENERATE_DATE_ARRAY. Harbor & Pine tiene ventas todos los meses, así que aquí no lo necesitas, pero con datos dispersos (un producto, una región pequeña) sí lo harás.

Errores comunes

• Agrupar por el timestamp en bruto: una fila por segundo, no por mes.
• Dar formato de texto al mes, como 'Mar 2025', y luego ordenarlo: abril se ordena antes que enero. Conserva una fecha real para ordenar y da formato al final del todo, o en la herramienta de gráficos.

En SQL Server

DATETRUNC(month, o.order_date) existe desde SQL Server 2022. En versiones anteriores construye el primer día con DATEFROMPARTS(YEAR(o.order_date), MONTH(o.order_date), 1). EOMONTH(o.order_date) devuelve el último día del mes, que algunos informes financieros usan como clave de mes en su lugar.