Reference for Intl.DurationFormat

[romulocintra]

Summary

MDN Docs for https://github.com/tc39/proposal-intl-duration-format

Supporting details

• https://bugzilla.mozilla.org/show_bug.cgi?id=1648139
• https://bugs.chromium.org/p/v8/issues/detail?id=11660
• https://bugs.webkit.org/show_bug.cgi?id=214794

Related issues

tc39/ecma402-mdn#22

Metadata

• Adds a new document
• Rewrites (or significantly expands) a document
• Fixes a typo, bug, or other error

[github-actions]

Preview URLs (6 pages)

• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/DurationFormat
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/formatToParts
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/format
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/resolvedOptions
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl

Flaws (5)

Note! 1 document with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat
Title: Intl.DurationFormat
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: javascript.builtins.Intl.DurationFormat

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/DurationFormat
Title: Intl.DurationFormat() constructor
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: javascript.builtins.Intl.DurationFormat.DurationFormat

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/format
Title: Intl.DurationFormat.prototype.format()
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: javascript.builtins.Intl.DurationFormat.format

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/resolvedOptions
Title: Intl.DurationFormat.prototype.resolvedOptions()
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: javascript.builtins.Intl.DurationFormat.resolvedOptions

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/formatToParts
Title: Intl.DurationFormat.prototype.formatToParts()
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: javascript.builtins.Intl.DurationFormat.formatToParts

External URLs (1)

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/resolvedOptions
Title: Intl.DurationFormat.prototype.resolvedOptions()

• https://datatracker.ietf.org/doc/html/rfc5646 (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2023-03-30 07:56:39)

[romulocintra]

Still missing a few things but we can start reviewing

• Examples for formatToParts
• Browser Compat

[wbamberg]

@romulocintra , sorry to be so slow getting to this PR. It looks like this isn't implemented anywhere yet, so I'm not sure we are ready to have docs on MDN for it (also it's hard, for example, for me to check that the examples work properly).

Perhaps it would be best to reopen this PR when it is implemented in at least one browser?

[romulocintra]

@romulocintra , sorry to be so slow getting to this PR. It looks like this isn't implemented anywhere yet, so I'm not sure we are ready to have docs on MDN for it (also it's hard, for example, for me to check that the examples work properly).

Perhaps it would be best to reopen this PR when it is implemented in at least one browser?

Converted it to Draft, as soon we have an implementation will re-open it. thanks @wbamberg

cc @sffc

[teoli2003]

Nice job!

I'm so excited to see this work getting closer to being ready to be merged as soon as a browser implements this feature. So, I went ahead with a first pass of reviews.

To save you time, I crafted suggestions for most comments:

• These are primarily typographic corrections.
• I also fixed some details to prevent our linters (Markdownlint, Prettier) from complaining.
• I removed Tags: as we removed them from the whole of MDN since the first version of this PR.
• I added page-type: instead, as this is what replaced them.

There will be a second pass later, but that way, all these typographic thingies won't get in the way.

Thanks a lot for your work.

[romulocintra]

Nice job!

I'm so excited to see this work getting closer to being ready to be merged as soon as a browser implements this feature. So, I went ahead with a first pass of reviews.

To save you time, I crafted suggestions for most comments:

• These are primarily typographic corrections.
• I also fixed some details to prevent our linters (Markdownlint, Prettier) from complaining.
• I removed Tags: as we removed them from the whole of MDN since the first version of this PR.
• I added page-type: instead, as this is what replaced them.

There will be a second pass later, but that way, all these typographic thingies won't get in the way.

Thanks a lot for your work.

Thanks you for such detailed review at 1st pass and all suggestions

[Josh-Cena]

This is implemented in Safari 16.4, and these docs look comparable to other Intl pages in terms of structure and content, so I think it's near ready to go.

[teoli2003]

@romulocintra When you bring this PR out of draft (meaning you think it is ready), we can merge it. Note that in case, we can always continue work in follow-ups.

[teoli2003]

\o/

[romulocintra]

\o/

Thank you for following along, this was quite long journey thank you again

[Elchi3]

Is there no supportedLocalesOf here like there is for the other Intl APIs?

[romulocintra]

Is there no supportedLocalesOf here like there is for the other Intl APIs?

Yes @Elchi3 , good catch, there is I'll prepare PR upcoming days for it - https://tc39.es/proposal-intl-duration-format/#sec-Intl.DurationFormat.supportedLocalesOf