Expresión cron de 5 campos: orden, símbolos y trampas

Contenido
- Las cinco posiciones siempre siguen el mismo orden
- Con tres cosas —asterisco, asterisco/N y números— ya lo lees todo
- Esto es lo que pasa cuando la escribes a mano
- La trampa de poner día del mes y día de la semana a la vez
- Con otra zona horaria, se ejecuta a una hora completamente distinta
- Resumen
- Preguntas frecuentes
Las cinco posiciones siempre siguen el mismo orden
Una expresión cron está formada por cinco campos separados por espacios, y el orden siempre es minuto-hora-día-mes-día de la semana. Es una regla que se mantiene igual en cualquier crontab y en cualquier planificador de CI, así que basta con memorizarla una vez para seguir usándola siempre.
Posición
Significado
Rango de valores
1.ª
minuto
0~59
2.ª
hora
0~23
3.ª
día del mes (day-of-month)
1~31
4.ª
mes
1~12
5.ª
día de la semana (day-of-week)
0~6 o 0~7, según la implementación
El rango numérico del campo del día de la semana varía ligeramente según la implementación. Es habitual que tanto el 0 como el 7 se traten como domingo, pero esto cambia un poco de un cron a otro, así que en lugar de memorizar números es más seguro guiarte por el nombre del día que muestra la herramienta (lun/mar/mié, etc.).
Con tres cosas —asterisco, asterisco/N y números— ya lo lees todo
Los símbolos que van en cada posición se dividen en tres grandes tipos.
- Asterisco (*) — significa todos los valores posibles de esa posición. Si hay un asterisco en el campo "minuto", es cada minuto; si hay un asterisco en "día de la semana", es todos los días, sin importar el día de la semana.
- Asterisco/N (*/N) — es un paso que se repite cada N unidades. Si escribes */15 en el campo de los minutos, se ejecuta a los 0, 15, 30 y 45 minutos.
- Un número concreto — se ejecuta solo cuando se llega a ese valor. Si escribes 9 en el campo de la hora, se ejecuta exactamente a las 9.
A esto se añade la posibilidad de enumerar varios valores separados por comas. Si pones 1,3,5 en el campo del día de la semana, se ejecuta solo los lunes, miércoles y viernes; si pones 3,6,9,12 en el campo del mes, se ejecuta solo en el primer mes de cada trimestre. Con conocer estas cuatro combinaciones, una expresión como "0 9 * * 1-5" se interpreta al instante como "a las 9:00 de cada día, solo de lunes a viernes".
Esto es lo que pasa cuando la escribes a mano
Hasta un requisito tan simple como "ejecutar a las 9 de la mañana en días laborables" se vuelve confuso cuando toca escribirlo a mano. Acabas intercambiando el orden de minutos y horas, o tienes que volver a buscar en la documentación si el número del día de la semana empieza en 0 o en 1. Y una vez escrita la expresión, tampoco hay una forma clara de comprobar a qué hora se ejecutará realmente, así que es habitual registrarla en el crontab y enterarte al día siguiente, revisando los registros, de si acertaste o no.
Con este Generador de expresiones cron eliges minuto, hora, día, mes y día de la semana en desplegables y obtienes a la vez la expresión cron estándar de 5 campos y una explicación en lenguaje claro.

Como basta con ir eligiendo cada campo en los desplegables para que aparezcan la expresión y una explicación en lenguaje llano, puedes comprobar con tus propios ojos, antes de registrarla, si la hora es la que querías. Los patrones más habituales también están disponibles como preajustes, así que no hace falta construir la combinación desde cero cada vez.
La trampa de poner día del mes y día de la semana a la vez
La parte que más se malinterpreta del cron es cómo se comporta cuando especificas a la vez el día del mes (day-of-month) y el día de la semana (day-of-week). Hay quien quiere "ejecutar el día 15 de cada mes, pero solo si ese día es lunes" y pone 15 en el campo del día y 1 en el del día de la semana; sin embargo, la mayoría de las implementaciones de cron no tratan ambos campos con un AND, sino con un OR.
Es decir, en la práctica se ejecuta si se cumple cualquiera de las dos cosas: "el día 15 de cada mes" o "todos los lunes de ese mes". En los meses en que el 15 no cae en lunes, se ejecuta igualmente el día 15 sin falta, y además se ejecuta todos los lunes. Esta forma de actuar se aplica siempre que uno de los dos campos no sea un asterisco (*), así que conviene tener claro que, si quieres acotar día del mes y día de la semana a la vez para crear una "intersección", la sintaxis de cron por sí sola no puede expresarlo.
Si de verdad necesitas esa condición, lo habitual es sortearlo desde dentro del script que se ejecuta: en lugar de usar una condición del propio planificador, el script comprueba la fecha y el día de la semana de hoy y termina si no encajan.
Con otra zona horaria, se ejecuta a una hora completamente distinta
La expresión cron en sí no contiene información de zona horaria. La expresión no es más que una combinación de números, y en qué zona horaria se interpretan esos números depende por completo de la configuración del servidor, del planificador o del runner de CI donde se ejecuta el cron. Por eso, una expresión pensada como "todos los días a las 9 de la mañana" puede ejecutarse en la práctica a una hora local totalmente distinta si quien la ejecuta está ajustado a otra zona horaria.
Cada planificador tiene su propia forma de indicar la zona horaria y sus valores por defecto también varían, así que, si la hora exacta de ejecución es importante, la única forma segura es revisar directamente la configuración de zona horaria de ese planificador antes de registrar la expresión. Mejor no dar por hecho que coincidirá con tu reloj local.
Resumen
- Una expresión cron tiene cinco posiciones fijas en el orden minuto-hora-día-mes-día de la semana, y ese orden no cambia en ninguna implementación.
- Cada posición se rellena con uno de estos elementos: asterisco (*, todos los valores), asterisco/N (paso), un número concreto o una lista separada por comas (varios valores).
- Si especificas a la vez día del mes y día de la semana, se interpreta como un OR y no como un AND, así que puede ejecutarse con más frecuencia de la que pretendías.
- La hora de ejecución se determina según la zona horaria del servidor o del planificador donde corre el cron, por lo que conviene revisarla antes de registrarlo.
- El rango numérico del día de la semana cambia según la implementación, así que es más seguro guiarte por el nombre del día que por el número.
Con este Generador de expresiones cron eliges minuto, hora, día, mes y día de la semana en desplegables y obtienes a la vez la expresión cron estándar de 5 campos y una explicación en lenguaje claro.
Preguntas frecuentes
En una expresión cron, ¿el 0 del día de la semana es domingo o lunes?
Depende de la implementación. Es habitual que el 0 se trate como domingo y que el 7 también signifique domingo por separado, pero esto varía un poco de un cron a otro. En lugar de memorizar el número, es más seguro fijarte en el nombre del día que muestra la herramienta o el planificador que estás usando.
Quiero que se ejecute el día 15 de cada mes y solo si cae en lunes, ¿cómo lo hago?
Con la sintaxis estándar de cron no puedes acotar a la vez los campos de día del mes (day-of-month) y día de la semana (day-of-week) para crear una condición de intersección. Si especificas ambos campos, se interpretan como un OR: se ejecuta sin falta el día 15 y también sin falta todos los lunes. Si necesitas de verdad esa intersección, lo habitual es implementarlo dentro del script que se ejecuta, comprobando la fecha y el día de la semana de hoy y terminando si no encajan.
Registré una expresión cron pero no se ejecuta a la hora que esperaba
Lo primero que conviene revisar es la zona horaria. La expresión cron no lleva información de zona horaria y se interpreta según la que tenga configurada quien la ejecuta (el servidor, el planificador, el runner de CI), así que puede no coincidir con tu reloj local. Después, comprueba si has especificado a la vez los campos de día del mes y de día de la semana, para descartar que se esté ejecutando con más frecuencia de la prevista por una condición OR no deseada.
¿Cuál es exactamente la diferencia entre el asterisco (*) y asterisco/N (paso)?
El asterisco (*) significa todos los valores posibles de esa posición, así que en el campo de los minutos quiere decir que se cumple la condición cada minuto. Asterisco/N significa que, de todos esos valores, se toman solo los que van saltando de N en N: si escribes */15 en el campo de los minutos, la condición se cumple solo a los 0, 15, 30 y 45 minutos. Dicho de otro modo, asterisco/N es el rango completo que genera el asterisco (*) con una condición de intervalo regular encima.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano