NatLabRockies / NatLabRockies/developer.nlr.gov

Returning dates/times as unix timestamps vs ISO strings

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

Nobody has claimed this yet.

ux-feedback
Dominant language
HTML
Stars
60
Forks
57
Avg merge
1d 21h
Merged PRs (30d)
3

Description

Feedback from our API Usability Testing: One of the participants preferred if all times being returned from our APIs would be returned as unix timestamp integers. I think most of our APIs typically return things times as ISO 8601 strings. The preference for unix timestamps is that they can be added and subtracted directly without having to first parse and create date objects in your language based on the ISO 8601 string.

Contributor guide

No contributing guide indexed for this repository

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

No file, endpoint, or failing test is identified. Start by reviewing the APIs' existing date and time response conventions and the linked API Usability Testing feedback. Done would require a decided, documented timestamp format and an agreed scope for affected API responses.

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
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.