#394 · Herramienta para desarrolladores

GitHub Actions Cron Builder

Prepara una programación cron para GitHub Actions usando sus cinco campos estándar. Puedes escribir minuto, hora, día del mes, mes y día de la semana en un formato legible, obtener la expresión final y generar el bloque YAML de on.schedule. El builder valida caracteres y rangos básicos, y recuerda que los workflows programados de GitHub Actions interpretan cron en UTC.

Datos de entrada

Campos cron
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Escribe los cinco campos como minute, hour, day, month y weekday usando clave=valor.
  2. Usa *, listas, rangos o pasos compatibles con cron cuando los necesites.
  3. Activa el bloque YAML si quieres una salida lista para on.schedule.
  4. Comprueba la hora en UTC antes de guardar el workflow.

Qué hace esta herramienta para desarrolladores

La expresión final contiene cinco campos en el orden minuto, hora, día del mes, mes y día de la semana. El modo YAML la inserta en una entrada schedule de GitHub Actions.

Se normalizan las cinco claves, se validan caracteres y números contra rangos básicos y se compone la expresión cron. No se calcula una próxima ejecución porque reglas complejas de cron requieren un motor de calendario completo.

GitHub Actions programa cron en UTC. Si quieres ejecutar a una hora local, debes convertirla considerando también cambios estacionales cuando correspondan.

Ejemplo

minute=30 hour=7 day=* month=* weekday=1-5

Produce 30 7 * * 1-5, es decir, una programación de lunes a viernes a las 07:30 UTC.

Casos de uso

  • Programar pruebas nocturnas.
  • Ejecutar una sincronización de lunes a viernes.
  • Lanzar tareas mensuales desde un workflow.

Consejos para obtener resultados fiables

  • Documenta siempre que la hora está expresada en UTC.
  • Evita schedules excesivamente frecuentes si el job consume muchos minutos.
  • Comprueba rangos y listas antes de hacer push.
  • No confundas día del mes con día de la semana.
  • Revisa la documentación actual de GitHub si necesitas restricciones de frecuencia.

Detalles del procesamiento

El validador local revisa los cinco campos y rangos numéricos evidentes. Acepta caracteres comunes de cron como *, coma, guion, barra y signo de interrogación, aunque no interpreta semánticamente todas sus combinaciones.

No garantiza que una expresión compleja sea aceptada por todas las implementaciones cron ni calcula zonas horarias locales; el objetivo es construir y revisar el schedule usado por GitHub Actions.

Preguntas frecuentes

¿En qué zona horaria se ejecuta un cron de GitHub Actions?

Los schedules de GitHub Actions se expresan en UTC, por lo que debes convertir la hora local antes de definir hour y minute.

¿Cómo creo un cron de GitHub Actions de lunes a viernes?

Usa un rango de weekday como 1-5 y define minute y hour en UTC.

¿El builder acepta listas y pasos como 0,30 o */15?

Sí, el validador permite comas, guiones y barras en los campos. Aun así, debes confirmar que la expresión concreta sea compatible con GitHub Actions.

¿Por qué no muestra automáticamente la próxima ejecución?

Calcular la próxima fecha de expresiones cron complejas exige reglas de calendario adicionales; esta utilidad se centra en construir y validar el texto del schedule.

¿Puedo pegar la salida directamente en un workflow YAML?

Sí cuando está activada la opción de bloque YAML. Ajusta la indentación si la insertas dentro de una estructura existente.

Módulos de la herramienta

MóduloQué comprueba o genera
Parser de camposLee minute, hour, day, month y weekday.
ValidadorComprueba caracteres y rangos numéricos básicos.
Generador YAMLEmite la expresión o el bloque on.schedule.