Cómo analizar una expresión cron de cinco campos

Qué puedes comprobar con una expresión cron

Cron Expression Parser sirve para comprobar una expresión cron de cinco campos y calcular sus cinco próximas ejecuciones. Es útil cuando quieres revisar si una programación tiene la estructura esperada y ver las fechas y horas que produciría, sin interpretar los campos manualmente. El orden importa: minuto, hora, día del mes, mes y día de la semana. Si no introduces ninguna expresión, se utiliza */5 * * * *.

Cómo analizar la expresión paso a paso

1. Introduce la expresión cron que quieras revisar. Debe estar formada por cinco campos separados por espacios. Antes de validarla, las secuencias de espacios se reducen a un solo espacio y se eliminan los espacios del principio y del final, por lo que puedes corregir ese formato sin modificar manualmente cada separación.

2. Comprueba que los campos siguen este orden: minuto, hora, día del mes, mes y día de la semana. Escribe la expresión completa y ejecuta la comprobación. Si contiene un número de campos distinto de cinco, el proceso termina con un resultado fallido antes de calcular las fechas.

3. Revisa la respuesta. Cuando la expresión es válida y encuentra coincidencias, se muestran las cinco próximas ocurrencias como fechas y horas en formato ISO, identificadas con la zona horaria UTC. El cálculo parte de la hora UTC actual, sin tener en cuenta las fracciones de segundo.

4. Si necesitas una programación mensual, por ejemplo, puedes usar 0 0 1 * *: sus coincidencias corresponden al primer día de cada mes a medianoche. Ten presente que, cuando se restringen a la vez el día del mes y el día de la semana, la coincidencia se aplica con lógica OR: basta con que se cumpla una de esas dos condiciones.

5. Si aparece un resultado fallido, revisa tanto la sintaxis como los valores y la estructura de la expresión. Una expresión que sea válida en sintaxis también puede fallar si no tiene ninguna coincidencia próxima dentro del límite de búsqueda de diez años.

Cómo interpretar el resultado y sus límites

Una respuesta correcta contiene cinco próximas ocurrencias del calendario, no una explicación libre de cada símbolo. Las cadenas de fecha y hora están formateadas según ISO y señalan UTC, así que conviene tener en cuenta esa zona horaria al comparar los resultados con la hora local de España u otra ubicación.

El resultado depende del momento actual desde el que comienza la búsqueda. Por eso, las fechas concretas pueden cambiar con el tiempo aunque la expresión no se modifique. También pueden cambiar según el calendario definido por la expresión: 0 0 1 * * produce ocurrencias en el primer día de los meses, mientras que otras combinaciones pueden ser más frecuentes.

Un resultado fallido no implica una única causa. Puede deberse a una expresión con una sintaxis o un número de campos no válidos, a valores que no se pueden interpretar o a la ausencia de una coincidencia dentro de diez años. La herramienta no devuelve las cinco fechas cuando se produce uno de esos fallos. Además, que una expresión sea válida no significa que vaya a generar una coincidencia dentro del periodo de búsqueda configurado.

Ejemplo práctico

Quieres comprobar una tarea que debe ejecutarse a medianoche el primer día de cada mes.

Para revisar una programación mensual, introduce 0 0 1 * * y ejecuta la comprobación.

La respuesta debe tener cinco fechas y horas en formato ISO, identificadas como UTC, correspondientes a los próximos primeros días de mes a medianoche si existen dentro del límite de búsqueda.

Limitaciones

• La búsqueda está limitada a diez años entre coincidencias. Además, las restricciones simultáneas de día del mes y día de la semana se combinan con lógica OR.

Errores frecuentes

• Un error frecuente es pegar una expresión con seis campos o colocar las partes en otro orden. Corrígela dejando cinco campos y revisa que correspondan a minuto, hora, día del mes, mes y día de la semana.

Preguntas frecuentes

¿Por qué una expresión cron válida puede devolver un resultado fallido?

Solo si la expresión no contiene ninguna coincidencia próxima dentro del límite de búsqueda de diez años, aunque su sintaxis sea válida. También puede fallar por un número de campos, una sintaxis o unos valores no válidos.

¿En qué zona horaria aparecen las próximas ejecuciones?

Sí, pero el resultado identifica las fechas y horas en UTC. El cálculo comienza en la hora UTC actual, sin fracciones de segundo, y devuelve las cinco ocurrencias siguientes cuando las encuentra.

¿Qué ocurre si no escribo una expresión cron?

Solo si omites la expresión: en ese caso se usa */5 * * * *. Si introduces una expresión, debe contener cinco campos en el orden minuto, hora, día del mes, mes y día de la semana.