Expresiones cron: cómo leer los 5 campos con ejemplos

Contenido
Situaciones reales en las que una expresión cron te confunde
En el archivo crontab de un servidor o en la configuración de programación de un CI/CD, muchas veces solo queda una línea de cinco números y símbolos como '0 3 1,15 * 3', sin ninguna explicación. Si la persona que creó la expresión ya no está o si el equipo recibió esa configuración tal cual, no hay a quién preguntar qué día se ejecuta exactamente esa línea.
El problema aparece sobre todo cuando el campo de día del mes (day-of-month) y el de día de la semana (day-of-week) tienen valor a la vez. '1,15' apunta al día 1 y al 15 de cada mes, y '3' apunta al miércoles.
Según si esos dos campos se leen como una intersección («el día 1 y además miércoles») o como una unión («el día 1 o cualquier miércoles»), el número de ejecuciones al mes cambia mucho. Si no conoces bien la regla del campo, mirando solo la notación no puedes decidir cuál de las dos es.
Cómo interpretarla a mano, sin herramientas
Una expresión cron se puede resolver a mano, paso a paso, sin ninguna herramienta.
Paso 1 — Divide los cinco campos en orden y revisa sus rangos. Los campos separados por espacios van siempre en el orden 'minuto hora día mes día de la semana', y cada uno tiene su propio rango de valores.
Campo
Posición
Rango de valores
Minuto
1.º
0-59
Hora
2.º
0-23
Día (day-of-month)
3.º
1-31
Mes
4.º
1-12 (JAN-DEC)
Día de la semana (day-of-week)
5.º
0-7 (SUN-SAT, tanto 0 como 7 son domingo)
Si la expresión no tiene exactamente 5 campos (por ejemplo, una macro como '@daily' o una entrada con otro número de campos), no es esta notación estándar de 5 campos.
Paso 2 — Separa cada campo por comas e interpreta cada parte. Si dentro de un campo hay comas (,), el valor que ese campo hace coincidir es la unión de los valores que representa cada parte. Cada parte es una de estas cuatro formas.
- '*' — todo el rango de ese campo
- 'a-b' — el rango de a a b, con ambos extremos incluidos
- un único número 'a' — ese valor concreto
- 'a/n' o '*/n' — valores que saltan desde el inicio en intervalos de n. '*/n' salta desde el valor mínimo del campo y 'a/n' salta desde a hasta el valor máximo del campo.
Paso 3 — Convierte las abreviaturas en inglés de mes y día de la semana a números. Los meses van de JAN=1 a DEC=12 y los días de la semana de SUN=0 a SAT=6. El campo de día de la semana admite el rango 0-7, y tanto 0 como 7 apuntan al domingo. Da igual escribir el domingo como 0 o como 7: es el mismo día.
Paso 4 — Comprueba si el día y el día de la semana están especificados a la vez. Si los campos de día del mes (day-of-month) y de día de la semana (day-of-week) no son ambos '*', los dos campos se combinan con un OR (unión), no con un AND (intersección).
Se ejecuta si ese día es uno de los días indicados o uno de los días de la semana indicados. Al contrario, si uno de los dos es '*', ese campo queda fuera de la condición y solo se evalúan los demás campos.
Por ejemplo, si resuelves '30 9 * * 1-5' en orden, sale esto.
- Minuto: 30 → minuto 30
- Hora: 9 → 9 horas
- Día: * → todos los días
- Mes: * → todos los meses
- Día de la semana: 1-5 → de lunes a viernes
Como el día y el mes son '*' y solo el día de la semana tiene valor, esta expresión se ejecuta de lunes a viernes a las 9:30.
Cuando el día y el día de la semana tienen valor a la vez, la lectura es distinta. Si resuelves '0 3 1,15 * 3' de la misma forma, sale esto.
- Minuto: 0, hora: 3 → 3:00
- Día: 1,15 → el día 1 y el día 15 de cada mes
- Mes: * → todos los meses
- Día de la semana: 3 → miércoles
Como ni el día (1, 15) ni el día de la semana (miércoles) son '*', se combinan con OR. Por eso esta expresión se ejecuta a las 3:00 el día 1 o el día 15 de cada mes, o también cualquier día que sea miércoles. No se limita a los días 1 y 15: también se ejecuta todos los miércoles de ese mes.
Compruébalo con nuestra herramienta.
Al introducir una expresión, se interpreta al instante campo por campo en el navegador y los datos no se envían al servidor.

Las notaciones que más confunden
Con conocer bien unas pocas reglas de la notación cron se resuelven la mayoría de las confusiones. Estos cinco puntos son los que se repiten una y otra vez.
Punto que confunde
Regla real
Día de la semana '0' y '7'
Los dos son domingo. No son días de la semana distintos.
Día del mes y día de la semana a la vez
No es un AND (intersección), sino un OR (unión). Basta con que se cumpla uno de los dos para que se ejecute.
Día de la semana '1-5'
No existe una notación aparte para «días laborables»: se expresa como el rango del lunes (1) al viernes (5).
'*/15' y '5/15'
'*/15' va de 0 en intervalos de 15 (0, 15, 30, 45), y '5/15' va desde 5 hasta el valor máximo de ese campo en intervalos de 15 (5, 20, 35, 50). El punto de partida es distinto.
Macros como '@daily'
No son la notación desplegada en los cinco campos de minuto, hora, día, mes y día de la semana, así que se tratan de forma distinta al formato estándar de 5 campos.
Si un valor de campo se sale del rango establecido (por ejemplo, 60 en el campo de los minutos) o si el número de campos no es 5, la expresión no se interpreta como válida.
Resumen
Al leer una expresión cron, lo que hay que comprobar se resume en estos cinco puntos.
- Los campos son siempre 5 y van en el orden 'minuto hora día mes día de la semana'.
- '*', los rangos (a-b), las listas (a,b) y los intervalos (a/n, */n) se expanden a un conjunto de valores según su propia regla, y las partes separadas por comas se unen en una unión.
- El campo de día de la semana admite el rango 0-7, y tanto 0 como 7 apuntan al domingo.
- Si especificas el día y el día de la semana a la vez, se aplica un OR, no un AND.
- Las reglas se pueden resolver a mano, pero cuando se cruzan varios campos es más rápido y más exacto ordenarlos en una tabla.
Al introducir una expresión, se interpreta al instante campo por campo en el navegador y los datos no se envían al servidor.
Preguntas frecuentes
¿Puedo usar 0 y 7 sin problema en el día de la semana?
Sí. El campo de día de la semana acepta valores de 0 a 7, y tanto 0 como 7 se tratan como domingo. El 6 es sábado y del 1 al 5 son, respectivamente, de lunes a viernes.
Si pongo el día del mes y el día de la semana, ¿tienen que cumplirse las dos condiciones?
No. Si el día del mes (day-of-month) y el día de la semana (day-of-week) están los dos rellenos con valores distintos de '*', se aplica un OR (unión). Por ejemplo, si pones '1,15' en el día y '3' (miércoles) en el día de la semana, se ejecuta el día 1 y el día 15 de cada mes y también todos los miércoles de ese mes.
Al contrario, si uno de los dos es '*', ese campo queda fuera de la condición y solo se aplican los demás campos.
¿'*/15' y '5/15' significan lo mismo?
No. '*/15' salta desde el valor mínimo de ese campo (0 en el caso de los minutos) en intervalos de 15, así que da 0, 15, 30, 45. La forma 'a/n', '5/15', salta desde 5 hasta el valor máximo de ese campo en intervalos de 15, así que da 5, 20, 35, 50. Como el valor de inicio es distinto, el conjunto de valores resultante también lo es.
¿La expresión que escribo se envía a un servidor?
No. La interpretación de la expresión se hace por completo dentro del navegador, y lo que escribes no se envía ni se guarda en ningún servidor.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano