cron.go RawHistoryFolder

1package domain
2
3import (
4	"fmt"
5	"strconv"
6	"strings"
7	"time"
8)
9
10// CronSchedule represents a recurring schedule: a preset, an optional time
11// of day, and the timezone that time is read in.
12//
13// When At is nil the preset keeps its built-in time (daily 02:00, weekly
14// Sunday 03:00, monthly day 1 04:00, hourly on the hour). When Location is
15// nil times are read in UTC.
16type CronSchedule struct {
17	Preset   BackupSchedule
18	At       *TimeOfDay
19	Location *time.Location
20}
21
22// TimeOfDay is a wall-clock time. Hourly schedules use only Minute.
23type TimeOfDay struct {
24	Hour   int
25	Minute int
26}
27
28// String formats the time as HH:MM.
29func (t TimeOfDay) String() string {
30	return fmt.Sprintf("%02d:%02d", t.Hour, t.Minute)
31}
32
33// ParseTimeOfDay parses a 24-hour "HH:MM" wall-clock time.
34func ParseTimeOfDay(raw string) (TimeOfDay, error) {
35	hh, mm, ok := strings.Cut(strings.TrimSpace(raw), ":")
36	if !ok || len(hh) == 0 || len(hh) > 2 || len(mm) != 2 {
37		return TimeOfDay{}, fmt.Errorf("time must use 24-hour HH:MM format, got %q", raw)
38	}
39	hour, errH := strconv.Atoi(hh)
40	minute, errM := strconv.Atoi(mm)
41	if errH != nil || errM != nil || hour < 0 || hour > 23 || minute < 0 || minute > 59 {
42		return TimeOfDay{}, fmt.Errorf("time must use 24-hour HH:MM format, got %q", raw)
43	}
44	return TimeOfDay{Hour: hour, Minute: minute}, nil
45}
46
47// CronEntry represents a registered cron job.
48type CronEntry struct {
49	ID       string
50	Name     string
51	Schedule CronSchedule
52	LastRun  time.Time
53	NextRun  time.Time
54	Running  bool
55}