Skip to content
This repository has been archived by the owner on Dec 3, 2017. It is now read-only.

Unify formats for displaying dates and times #553

Closed
noahmanger opened this issue Oct 24, 2016 · 9 comments
Closed

Unify formats for displaying dates and times #553

noahmanger opened this issue Oct 24, 2016 · 9 comments
Assignees

Comments

@noahmanger
Copy link
Contributor

We currently display dates and times in a number of formats throughout the design. While not urgent, I think it would be good to at some point clean up the approach we take.

For example:

MM-DD-YYYY:
image

MM/DD/YYYY:
image

mm dd, yyyy:
image

image

MM dd, YYYY
image

I think there's a lot of sense in having a format that's just digits, as these are easier to scan in data, and another that's actual month names. But we should probably standardize on / vs - and also decide when to use which.

Paging @emileighoutlaw and @jenniferthibault

@emileighoutlaw
Copy link
Contributor

Existing date displays (for reference):

screen shot 2016-10-25 at 5 06 46 pm

screen shot 2016-10-24 at 12 23 57 pm

screen shot 2016-10-24 at 12 17 31 pm

screen shot 2016-11-01 at 12 00 00 pm

screen shot 2016-11-01 at 11 57 24 am

screen shot 2016-11-01 at 11 56 29 am

@emileighoutlaw
Copy link
Contributor

emileighoutlaw commented Nov 2, 2016

Months and ordinals

  • It's faster for readers to parse November 8, 2016 than November 8th, 2016.
  • It's easier to read November 8, 2016 than 11/8/16. (There's also a small argument to be made that, for international users, the ordering of mm/dd is unexpected, and writing the month out eliminates any confusion.)

Conclusion: We should display dates as: November 8, 2016.

That isn't feasible in many charts, but more on that next.

Displaying dates in charts and graphs

  • 11-08-2016 will linebreak partway through, whereas 11/08/2016 won't:
    screen shot 2016-11-02 at 1 40 06 pm

Conclusion: Dates should follow this format: 11/08/2016

Ranges

Our brilliant EITI folks (h/t @gemfarmer) did testing on ranges:

  • It's easier for users to scan and read ranges that have the word "to" in them. This jives with my content strategy upbringing that "to" is more accessible for readers than "–" (n dash). It's also a slightly better experience for screen readers (which read a dash as "dash" and not "to").

Conclusion: Depending on context, ranges should follow one of two patterns: November 8 to 9, 2016 or 11/08/2016 to 11/09/2016

If this reasoning sounds good to @jenniferthibault and @noahmanger, I'll start working on implementation. :)

@noahmanger
Copy link
Contributor Author

This makes a ton of sense to me. Seems like a great way to go.

@emileighoutlaw
Copy link
Contributor

emileighoutlaw commented Nov 4, 2016

This will be complete when dates are unified in:

  • Registration and reporting
  • Data (filters, candidate/committee pages)
  • Legal resources
  • Press section
    • (Exception for existing Weekly Digests, which are formatted as Month DD, YYYY — Month DD, YYYY)

@noahmanger
Copy link
Contributor Author

@emileighoutlaw do you need a developer to pick up the task of getting these everywhere else?

@emileighoutlaw
Copy link
Contributor

I'm actually trying to muddle through on my own first (because I want to be better at HTML) :)

@emileighoutlaw
Copy link
Contributor

Hey @noahmanger — I'm actually struggling to find and get through this. Maybe it would be smarter and more time-efficient to have a developer pick up this task and me review the PR. I'm starting to be a blocker on this, and that feels icky.

@noahmanger
Copy link
Contributor Author

Sounds good. Yeah this gets tricky because the date formatters live in a few places.

@jenniferthibault
Copy link
Contributor

I did a quick review and didn't find any outstanding places in legal resources where the dates were inconsistent with the decisions above. Closing

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

3 participants