Go Academy · Lezione

La libreria robfig/cron

Pianificare con la sintassi cron

La libreria robfig/cron è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Go Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Go Academy include 4 lezioni in totale.

Le espressioni cron in Go

La libreria robfig/cron consente di pianificare i job con la familiare sintassi cron, invece di calcolare manualmente i tempi. La installi con go get github.com/robfig/cron/v3.

import "github.com/robfig/cron/v3"

Ripasso della sintassi cron

Un'espressione cron standard è composta da cinque campi:

minuto (0-59)
ora (0-23)
giorno del mese (1-31)
mese (1-12)
giorno della settimana (0-6)

Esempio: 0 9 * * 1-5 = le 9:00 nei giorni feriali.

Creare uno scheduler

cron.New() restituisce uno scheduler. Vi aggiunga i job, quindi lo avvii.

c := cron.New()
c.Start()
defer c.Stop()

Aggiungere un job

AddFunc registra una funzione da eseguire secondo una pianificazione e restituisce un ID della voce e un errore se la specifica non è valida.

id, err := c.AddFunc("30 * * * *", func() {
    fmt.Println("runs at minute 30")
})
if err != nil {
    log.Fatal(err)
}
_ = id

Il campo dei secondi

robfig/cron v3 utilizza per impostazione predefinita una specifica a 5 campi, senza i secondi. Per abilitare una specifica a 6 campi con i secondi, crei il cron con l'opzione dei secondi.

c := cron.New(cron.WithSeconds())
c.AddFunc("*/5 * * * * *", func() { fmt.Println("every 5s") })

Pianificazioni predefinite

Sono disponibili macro pratiche:

@hourly
@daily
@weekly
@every 1h30m

c.AddFunc("@every 1h30m", func() { fmt.Println("every 90 min") })
c.AddFunc("@daily", func() { fmt.Println("midnight") })

Rimozione dei job

Usi il valore EntryID restituito per rimuovere dinamicamente un job.

id, _ := c.AddFunc("@hourly", task)
// later:
c.Remove(id)

I job vengono eseguiti nelle goroutine

Ogni job pianificato viene eseguito nella propria goroutine. Se un job può sovrapporsi al trigger successivo, gestisca la concorrenza oppure usi un wrapper che salti le esecuzioni sovrapposte.

Fusi orari

Per impostazione predefinita, le pianificazioni usano l'ora locale della macchina. Passi una location per renderle esplicite ed evitare sorprese legate all'ora legale.

loc, _ := time.LoadLocation("America/New_York")
c := cron.New(cron.WithLocation(loc))

Analisi senza esecuzione

Può convalidare una specifica o calcolare la prossima esecuzione con un parser: è molto utile nei test e per mostrare agli utenti la prossima esecuzione.

sched, _ := cron.ParseStandard("0 9 * * 1-5")
next := sched.Next(time.Now())
fmt.Println("next run:", next)

Eseguibile: calcolo della prossima esecuzione di cron (analogia)

robfig/cron è esterno; questo snippet della libreria standard modella la regola cron più semplice, "ogni minuto all'inizio del minuto", calcolando il prossimo orario corrispondente.

package main

import (
    "fmt"
    "time"
)

func nextRun(from time.Time) time.Time {
    return from.Truncate(time.Minute).Add(time.Minute)
}

func main() {
    now := time.Date(2026, 1, 1, 8, 15, 30, 0, time.UTC)
    fmt.Println("now:", now.Format("15:04:05"))
    fmt.Println("next:", nextRun(now).Format("15:04:05"))
}

Verifica rapida

Verifichi la Sua comprensione della libreria robfig/cron.

Riepilogo

Ha imparato a usare la libreria robfig/cron:

cron.New() + AddFunc(spec, fn) + Start()
Per impostazione predefinita, le specifiche hanno 5 campi; WithSeconds aggiunge un campo per i secondi
Macro come @daily e @every semplificano le pianificazioni comuni
Usi Remove, le location e ParseStandard per avere controllo ed eseguire test

Domande Frequenti

La lezione «La libreria robfig/cron» è gratuita?

Sì — il testo completo di «La libreria robfig/cron» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Go Academy, passa a CoddyKit PRO. Il corso Go Academy include 4 lezioni in totale.

Cosa imparerò in «La libreria robfig/cron»?

Pianificare con la sintassi cron Eserciti Go Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Go Academy?

Non è richiesta alcuna esperienza precedente. Go Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.

Quanto tempo richiede la lezione «La libreria robfig/cron»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Go Academy?

Sì. Ogni lezione Go Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Go Academy