id = "date"
name = "date"
description = "Display or set the date and time (BSD/macOS options)."
executables = ["date"]
platforms = ["macos"]

[commands]
format = 1
label = "Print a date"
description = "Display a date, optionally in UTC, RFC 2822 format, converted from epoch seconds or adjusted. Setting the system clock is not offered."
quality = "ai-draft"
base = "fig:date"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/date.ts"
license = "MIT"

[[commands.field]]
id = "utc"
label = "UTC"
type = "boolean"
option = ["-u"]
sources = ["fig"]

[[commands.field]]
id = "rfc2822"
label = "RFC 2822 output"
type = "boolean"
option = ["-R"]
sources = ["fig"]

[[commands.field]]
id = "epoch"
label = "From epoch seconds"
type = "string"
option = ["-r"]
sources = ["fig"]

[[commands.field]]
id = "adjust"
label = "Adjust"
description = "Adjustment such as +1d or -2H."
type = "string"
option = ["-v"]
multiple = true
sources = ["fig"]

[[commands.field]]
id = "format"
label = "Output format"
description = "A + followed by a strftime format, e.g. +%Y-%m-%d."
type = "string"
position = 0
suggestions = [{ value = "+%Y-%m-%d", label = "ISO date" }, { value = "+%s", label = "Epoch seconds" }]
sources = ["fig"]

[[commands.task]]
id = "print"
label = "Print formatted date"
fields = ["utc", "format"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["utc", "rfc2822", "epoch", "adjust", "format"]