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

PublicadoHerramientaGenerador de expresiones cron

Contenido
  1. Las cinco posiciones siempre siguen el mismo orden
  2. Con tres cosas —asterisco, asterisco/N y números— ya lo lees todo
  3. Esto es lo que pasa cuando la escribes a mano
  4. La trampa de poner día del mes y día de la semana a la vez
  5. Con otra zona horaria, se ejecuta a una hora completamente distinta
  6. Resumen
  7. 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.

Generador de expresiones cron

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.
Generador de expresiones cron

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

Artículos relacionados

  1. Expresiones cron: cómo leer los 5 campos con ejemplosAprende qué significan los campos de minuto, hora, día, mes y día de la semana, por qué 0 y 7 son domingo y cuándo se usa OR.
  2. EAN-13: el dígito de control y cómo calcularloLa última cifra del EAN-13 se obtiene de las 12 anteriores. Aprende a verificarla a mano con multiplicaciones y una resta, y por qué 880 no indica origen.
  3. Nombres de fantasía: las reglas de sonido de cada razaPor qué los nombres élficos suenan suaves y los orcos duros, y qué reglas de sonido usar para crear nombres de personajes coherentes con su raza.
  4. Cómo comprobar si un sorteo está amañado: repite y comparaRepite el mismo sorteo varias veces, anota los resultados y comprueba con una tabla de frecuencias si el programa favorece a alguien o es solo casualidad.
  5. gitignore no funciona: cómo dejar de rastrear archivosDescubre por qué .gitignore no se aplica a archivos ya rastreados y aprende a comprobarlo y a dejar de seguirlos con git rm --cached y sus patrones.
  6. Generador de hash SHA-256: cómo detectar datos alteradosQué calcula realmente un hash SHA-256, por qué el efecto avalancha detecta cambios y cómo comprobar el hash de un texto o archivo en el navegador.

Herramientas relacionadas