Support formatting units, eg. secs, days

[rxaviers]

PR #254

Format units such as seconds, minutes, days, weeks, and everything else supported by CLDR.

Requires

• Create Pluralization module #220 Plural

API

.formatUnit( value, unit [, options] );

Examples:

.formatUnit( 1, "month" ); // 1 month
.formatUnit( 5, "week" ); // 5 weeks
.formatUnit( 30, "day" ); // 30 days
.formatUnit( 30, "day", { form: "narrow" }); // 30d

Value: Number

Unit: String, eg. "month", "day", etc.

Options:

• form ("long"|"short"|"narrow") used when tense = null to specify the unit form, eg. ("2 seconds", "2 secs", or "2s").

Specs

• TR35 Unit Elements

CLDR

Units can be found on main//units.json.

Ecma proposal

• Unit formatting API tc39/ecma402#32

Fore more background: see #391.

[arkihillel]

This is a must have as far as I'm concerned. Would be glad to help if needed.
What I tried to do a week ago before realizing I couldn't with the current version of globalize might help you get a clear use case:

Display week dates

// Globalize initialization omitted
function formatWeek(startDate) {
    var startDate = new Date(startDate);
    // _ is gettext
    var i18nString = _('%s of %s to %s');
    var i18nWeek = Globalize.formatUnit( 1, "week" );
    var i18nFirstDay = Globalize.formatDate(startDate, {skeleton: 'yMd'});
    var i18nLastDay = Globalize.formatDate(startDate.setDate(startDate.getDate() + 6), language, {skeleton: 'yMd'});
    return util.format(i18nString, i18nWeek, i18nFirstDay, i18nLastDay);
}

[rxaviers]

It was not clear to me whether the API specified here (and partially implemented by #252) is sufficient for you? If it is, you can help me to finish #252, so we can land it. Right now, it misses functional tests and docs. It got stalled due to lack of time/resource to work on it.

[arkihillel]

#252 perfectly fits my needs. I'd be glad to help and will look into documenting it whenever I have free time.

[rxaviers]

Awesome, feel free to add comments needing help. As soon as we get those items tick, it should be good to land on master.

[rxaviers]

Ecma proposal

• Unit formatting API tc39/ecma402#32