clock

func FilenameUTC ¶

func FilenameUTC(t time.Time) string

FilenameUTC formats t using filenameLayout, always in UTC regardless of t's own location — e.g. time.Now() at 11:26:16+05:30 becomes "2026-09-28T05-56-16Z".

Always UTC, deliberately: this format is used for machine-generated, embedded-in-a-filename timestamps (snapshot archive names, quarantine collision suffixes) where "lexical order == chronological order" is relied on elsewhere (ApplyRetention's snapshot pruning). Local time can move backward in wall-clock terms across a DST "fall back" transition, which would silently break that invariant; UTC has no DST, so it can't.

func FilenameUTCNow ¶

func FilenameUTCNow() string

FilenameUTCNow is FilenameUTC(time.Now()).

func LocalRFC3339 ¶

func LocalRFC3339(t time.Time) string

LocalRFC3339 formats t as local time in RFC3339, with a numeric UTC offset — e.g. "2026-09-28T11:26:16+05:30". Used for anything a person reads directly: structured log entries, gitback health's generated_at, mirrors.json's sync times.

func LocalRFC3339Now ¶

func LocalRFC3339Now() string

LocalRFC3339Now is LocalRFC3339(time.Now()).