OAI / OAI/spec.openapis.org

Format request for toggling `timezone` awareness of `date-time`

Open
#36 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
12
Forks
18
Avg merge
7h 31m
Merged PRs (30d)
4

Description

In some cases it makes sense work to further specific whether a date-time formatted string type in a definition contains timezone information. This is important in some programming languages, for instance python, which admit classes that contain or do not contain this information.

Would it be possible extend the choices from

format: date-time

to

format: date-time
format: date-time-zone
format: date-time-nozone

or something similar?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the issue's proposed date-time-zone and date-time-nozone format choices and determine the intended timezone semantics for OpenAPI date-time values. Done requires a decided format design and corresponding specification updates; no files or tests are named in the issue.

Written by the indexing model from the issue text.

Assessment

Domain
api
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.