These inputs are for editing date and time values in your data.
If timezone is set in your global configuration, date values are saved with the matching offset suffix. If unset, date values are saved without an offset suffix in UTC.
For Jekyll sites, date values are saved in the Jekyll-expected format (e.g. 2021-01-09 00:00:00) rather than standard ISO 8601.
Datetime#
Combination date picker and 12-hour time input.
Datetime inputs are shown for inputs configured with the type datetime, for date input values, or for input keys matching:
datedatetime*_datetimeat*_at
date: 2020-07-15T12:00:00.000Z
{
"date": "2020-07-15T12:00:00.000Z"
}date = 2020-07-15T12:00:00.000Z
when: 2020-07-15T12:00:00.000Z
_inputs:
when:
type: datetime
{
"when": "2020-07-15T12:00:00.000Z",
"_inputs": {
"when": {
"type": "datetime"
}
}
}when = 2020-07-15T12:00:00.000Z
[_inputs.when]
type = "datetime"
Date#
Date picker input for date values with year, month, and day.
Date inputs are shown for inputs configured with the type date, or for inputs keys matching:
*_date
sale_start_date: 2021-01-09T00:00:00.000Z
{
"sale_start_date": "2021-01-09T00:00:00.000Z"
}sale_start_date = 2021-01-09T00:00:00.000Z
due_by: 2021-01-09T00:00:00.000Z
_inputs:
due_by:
type: date
{
"due_by": "2021-01-09T00:00:00.000Z",
"_inputs": {
"due_by": {
"type": "date"
}
}
}due_by = 2021-01-09T00:00:00.000Z
[_inputs.due_by]
type = "date"
The time value is always added for Date inputs as 00:00:00 for consistency with Datetime inputs.
Time#
Single line 12-hour time input for strings of time values.
Time inputs are shown for inputs configured with the type time, or for input keys matching:
time*_time
opening_time: 8:00 am
{
"opening_time": "8:00 am"
}opening_time = "8:00 am"
doors_open: 8:00 am
_inputs:
doors_open:
type: time
{
"doors_open": "8:00 am",
"_inputs": {
"doors_open": {
"type": "time"
}
}
}doors_open = "8:00 am"
[_inputs.doors_open]
type = "time"
Options#
Date, Datetime and Time input options are configured with options inside an _inputs entry.
Specifies the time zone that dates are displayed and edited in. Also changes the suffix the date is persisted to the file with. Must be in the tz database name format (e.g. Pacific/Auckland or America/New_York). Defaults to the timezone configured in your global configuration file, which defaults to Etc/UTC.
Available on Date and Datetime inputs, has no effect on Time inputs.
Set how an ‘empty’ value will be saved. Does not apply to existing empty values. Can be one of the following:
string- an empty value for this input will be stored as"".null- an empty value for this input will be stored as a null value (default). This does not apply to TOML files.
Valid values#
Documented below are the valid formats for date, datetime, and time inputs.
The lists of examples are non-exhaustive.
-
Date, time, and datetime inputs surrounded by quotation marks will be automatically unquoted when loaded into the Data Editor.
-
24hr times will be converted to 12hr times when loaded into the Data Editor.
Date and Datetime
Empty/null value:
datetime:
Empty string:
datetime: ""datetime: ''
ISO 8601 formatted datetime (quoted or unquoted):
datetime: 2020-07-15T12:00:00Zdatetime: '2020-07-15T12:00:00Z'datetime: "2020-07-15T12:00:00Z"
Empty string:
datetime = ""datetime = ''
ISO 8601 formatted datetime (quoted or unquoted):
datetime = 2020-07-15T12:00:00Zdatetime = "2020-07-15T12:00:00Z"datetime = '2020-07-15T12:00:00Z'
ISO 8601 formatted datetime with space instead of T (quoted or unquoted):
datetime = 2020-07-15 12:00:00Zdatetime = "2020-07-15 12:00:00Z"
The space will be converted to a T when loaded into the Data Editor
Null value:
"datetime": null
Empty string:
"datetime": ""
ISO 8601 formatted datetime:
"datetime": "2020-07-15T12:00:00Z"
Time
Empty/null value:
time:
Empty string:
time: ""time: ''
12hr time (quoted or unquoted):
time: 1:23 pmtime: '1:23 pm'time: "1:23 pm"
24hr time (quoted or unquoted):
time: 13:23:00time: '13:23:00'time: "13:23:00"
Empty string:
time = ""time = ''
12hr time:
time = "1:23 pm"time = '1:23 pm'
24hr time:
time = "13:23:00"time = '13:23:00'
Null value:
"time": null
Empty string:
"time": ""
12hr time:
"time": "1:23 pm"
24hr time:
"time": "13:23:00"