GameParticles
Desarrollo

Guía rápida de expresiones cron con ejemplos reales

La sintaxis de cron en una página: los cinco campos, los cuatro operadores, horarios listos para copiar y las trampas del OR entre días, el DST y las variantes.

Actualizado

Una expresión cron son cinco campos separados por espacios: minuto, hora, día del mes, mes y día de la semana. 0 9 * * 1-5 significa a las 09:00 de lunes a viernes. * significa todos los valores, , enumera valores, - define un rango y / establece un paso. Eso es casi toda la sintaxis; el resto de esta página son ejemplos y trampas.

Los cinco campos

En orden, con sus rangos permitidos:

  1. Minuto: 0-59
  2. Hora: 0-23 (reloj de 24 horas)
  3. Día del mes: 1-31
  4. Mes: 1-12 o JAN-DEC
  5. Día de la semana: 0-6, donde 0 es domingo (7 también significa domingo en la mayoría de los sistemas), o SUN-SAT

La expresión se dispara cuando la hora actual coincide con todos los campos, con una excepción que se explica más abajo. Las horas se evalúan en la zona horaria de la máquina o del servicio que ejecuta el planificador, que suele ser UTC en servidores y contenedores.

Operadores

  • * cualquier valor. * * * * * es cada minuto.
  • , lista. 0 9,17 * * * es a las 09:00 y a las 17:00.
  • - rango. 0 9-17 * * * es al inicio de cada hora desde las 09:00 hasta las 17:00, nueve ejecuciones.
  • / paso. */15 * * * * es cada 15 minutos: :00, :15, :30, :45. 0 */6 * * * es cada seis horas. Los pasos pueden empezar con un desplazamiento: 5/15 en el campo de los minutos significa :05, :20, :35, :50.

Los operadores se combinan: 0 8-18/2 * * 1-5 es cada dos horas de 08:00 a 18:00 de lunes a viernes.

Ejemplos reales

  • * * * * * cada minuto
  • */5 * * * * cada 5 minutos
  • 0 * * * * cada hora, en punto
  • 30 * * * * cada hora a las :30
  • 0 0 * * * a diario a medianoche
  • 0 3 * * * a diario a las 03:00, el horario clásico de las copias de seguridad
  • 0 9 * * 1-5 de lunes a viernes a las 09:00
  • 0 0 * * 0 semanal, el domingo a medianoche
  • 0 0 * * 1 semanal, el lunes a medianoche
  • 0 0 1 * * el primer día de cada mes a medianoche
  • 0 0 1 1 * una vez al año, el 1 de enero
  • 0 0 1 */3 * trimestral: 1 de enero, 1 de abril, 1 de julio, 1 de octubre
  • 0 9,13,17 * * * tres veces al día
  • 0 22 * * 1-5 las noches de lunes a viernes a las 22:00
  • 0 0 * * 6,0 sábado y domingo a medianoche
  • 15 2 * * * a las 02:15 a diario, desplazado respecto a la hora en punto
  • 0 0 */2 * * un día sí y otro no, más o menos; el paso se reinicia el día 1, así que un mes de 31 días termina con ejecuciones en días consecutivos

Escribir una de estas a mano es fácil. Comprobar que hace lo que querías es donde ayuda el generador de expresiones cron: convierte cualquier expresión en una frase en lenguaje natural y lista las próximas cinco ejecuciones.

Las trampas

El día del mes y el día de la semana son OR, no AND

Es la regla más sorprendente de cron. Si los dos campos de día están restringidos, la tarea se ejecuta cuando coincide cualquiera de ellos. 0 0 13 * 5 se ejecuta el día 13 de cada mes y todos los viernes, no solo el viernes 13. No hay sintaxis de cron estándar para "el 13 solo si es viernes"; haz esa comprobación dentro del script.

El último día del mes

El cron estándar no tiene L. 0 0 28-31 * * se dispara hasta cuatro veces. La solución habitual es ejecutar la tarea a diario y dejar que el script compruebe si date -d tomorrow +%d es igual a 01. Quartz (Java) y algunos planificadores en la nube amplían la sintaxis con L, W y #, pero esas expresiones no funcionan en un crontab de Linux.

El horario de verano

Una tarea en 0 2 * * * en una zona horaria con horario de verano (DST) se omitirá la noche en que el reloj se adelanta y se ejecutará dos veces la noche en que se atrasa. Programa los servidores en UTC o elige horas que nunca caigan en la ventana del cambio.

Variantes no estándar

  • El crontab de Linux acepta @hourly, @daily, @weekly, @monthly, @yearly y @reboot.
  • Quartz, Spring y algunos servicios de AWS usan seis o siete campos, con los segundos al principio y un año opcional al final. 0 0 9 * * ? es la forma de Quartz de decir a diario a las 09:00; el ? significa "ningún valor concreto" y es obligatorio en uno de los dos campos de día.
  • GitHub Actions y los CronJobs de Kubernetes usan los cinco campos estándar en UTC. GitHub también documenta que el intervalo mínimo permitido es de cinco minutos y que las tareas pueden empezar con retraso en momentos de mucha carga.
Cron no tiene memoria. Si la máquina está apagada o el contenedor no está en marcha en el minuto programado, esa ejecución simplemente se pierde. Usa una cola de tareas o un planificador que recupere las ejecuciones perdidas si cada ejecución importa.

Comprobar tu programación

La lista de próximas ejecuciones es la verificación más rápida. Si las cinco primeras horas no son las que imaginabas, la expresión está mal. Si la tarea escribe marcas de tiempo en logs o en una base de datos, convierte los valores epoch registrados con el conversor de timestamps Unix y compáralos con la programación prevista; un desfase de una hora después de un cambio de horario de verano es un hallazgo frecuente.

Para medir cuánto tiempo pasó de verdad entre dos ejecuciones, la calculadora de duración da el intervalo exacto en días, horas y minutos entre dos marcas de tiempo.

Hay más utilidades de programación y formato en la categoría para desarrolladores.

Pruébalo

Escribe o construye una expresión en el generador de expresiones cron, lee el resumen en lenguaje natural y confirma las próximas cinco ejecuciones antes de que llegue a un crontab, un flujo de CI o un manifiesto de CronJob.

Herramientas de esta guía

Preguntas frecuentes

¿Qué significa 0 0 * * * en cron?

El minuto 0 de la hora 0 de todos los días, todos los meses y todos los días de la semana: es decir, a diario a medianoche en la zona horaria del planificador.

¿Cómo ejecuto una tarea cron cada 5 minutos?

Usa */5 en el campo de los minutos: */5 * * * *. El operador de paso empieza en 0, así que se dispara a las :00, :05, :10 y así sucesivamente.

¿Por qué mi tarea cron se ejecuta en días de más cuando defino los dos campos de día?

En el cron estándar, el día del mes y el día de la semana se combinan con OR, no con AND. 0 0 13 * 5 se ejecuta el día 13 de cada mes y también todos los viernes.

¿Qué zona horaria usa cron?

La zona horaria del host o del servicio que ejecuta el planificador. Los servidores, los contenedores, GitHub Actions y los CronJobs de Kubernetes usan UTC por defecto salvo que se configure otra cosa.

Más guías para desarrolladores

Formateador de JSON
Desarrollo · Formatea, valida y minifica JSON con resaltado de sintaxis.
↵
Codificar / decodificar Base64
Desarrollo · Codifica texto en Base64 o decodifica Base64 a texto plano.
↵
Codificador / Decodificador de URL
Desarrollo · Codifica o decodifica componentes de URL y cadenas de consulta.
↵
Generador de hash
Desarrollo · Genera hashes MD5, SHA-1, SHA-256 y SHA-512.
↵
Generador de UUID
Desarrollo · Genera UUID v4 (aleatorios) en lote con un clic.
↵
Probador de regex
Desarrollo · Prueba expresiones regulares sobre un texto con resaltado de coincidencias en vivo.
↵
Contador de palabras
Texto · Cuenta palabras, caracteres, frases, párrafos y tiempo de lectura.
↵
Conversor de mayúsculas y minúsculas
Texto · Convierte texto a MAYÚSCULAS, minúsculas, Título, camelCase, snake_case y más.
↵
Ordenador de listas
Texto · Ordena, invierte, baraja y quita duplicados de listas de texto.
↵
Vista previa de Markdown
Texto · Escribe Markdown y mira la vista previa renderizada en vivo, lado a lado.
↵
Calculadora de porcentajes
Números · Calcula porcentajes, aumentos, descuentos y qué % es un número de otro.
↵
Conversor de colores
Colores · Convierte colores entre HEX, RGB, HSL y HSV al instante.
↵
Snake
Arcade · Come, crece y no choques con las paredes. Un clásico eterno.
↵
2048
Puzles · Desliza y combina fichas hasta conseguir la legendaria ficha 2048.
↵
Word Grid
Puzles · Adivina la palabra oculta de cinco letras en seis intentos con pistas de colores.
↵
Sudoku
Puzles · Completa la cuadrícula 9x9 con lógica. Cuatro niveles, de fácil a experto.
↵
Buscaminas
Estrategia · Usa las pistas numéricas para despejar el campo de minas. Lógica clásica, tres niveles.
↵
Breakout
Arcade · Rompe todos los ladrillos con barra y bola. Power-ups, combos y niveles sin fin.
↵
Práctica de mecanografía
Casual · Mejora tus PPM y tu precisión con prácticas de 30 segundos a 5 minutos. Descubre tus teclas débiles.
↵
TypeRunner
Arcade · Carrera de mecanografía multijugador. Reta a tus amigos con un enlace, vence a la máquina o persigue a tu fantasma.
↵
Typing Blocks
Arcade · Escribe cada palabra antes de que su bloque de madera aterrice. Si fallas, la pila sube hacia la línea.
↵
Bubble Shooter
Arcade · Apunta, rebota en las paredes y explota grupos de tres o más burbujas.
↵
Road Rush
Arcade · Corre contra siete rivales entre el tráfico y ábrete paso a golpes.
↵