Skip to content

Define time zone values and conversions #1078

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jul 21, 2025
Merged

Define time zone values and conversions #1078

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
6b48bbb
Define timeZone=local as the default time zone
eemeli Jun 8, 2025
ab811dd
Replace timeZone=local with timeZone=input
eemeli Jul 14, 2025
d4c52dd
Use "resolved value of the operand"
eemeli Jul 14, 2025
c53815a
More text edits
eemeli Jul 14, 2025
efc5d13
Apply suggestions from code review
eemeli Jul 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 8 additions & 5 deletions spec/functions/datetime.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -282,11 +282,14 @@ the functions `:datetime`, `:date`, and `:time`.
- `local`
- `UTC`

> [!NOTE]
> The value `local` permits a _message_ to convert a date/time value
> into a [floating](https://www.w3.org/TR/timezone/#floating) time value
> (sometimes called a _plain_ or _local_ time value) by removing
> the association with a specific time zone.
The value `local` corresponds to the default time zone.

If the _operand_ value does not include a time zone,
it is presumed to use the default time zone.
If the _operand_ value does include a time zone and the `timeZone` _option_ is set,
an implementation SHOULD convert the value to the time zone indicated by the _option_.
If such conversion is not supported, an implementation MAY alternatively
emit a _Bad Option_ error and use a _fallback value_ as the _resolved value_ of the _expression_.

The following _option_ is REQUIRED to be available on
the functions `:datetime` and `:time`:
Expand Down