Skip to content

Latest commit

 

History

History
66 lines (40 loc) · 1.36 KB

relative-time-formatter.md

File metadata and controls

66 lines (40 loc) · 1.36 KB
Raw

.relativeTimeFormatter( unit [, options] ) ➜ function( value )

Returns a function that formats a relative time according to the given unit, options, and the default/instance locale.

The returned function is invoked with one argument: the number value to be formatted.

Parameters

unit

String value indicating the unit to be formatted. eg. "day", "week", "month", etc.

options

  • form: [String] eg. "short" or "narrow". Or falsy for default long form

value

The number to be formatted.

Example

Prior to using any relative time methods, you must load cldr/main/{locale}/dateFields.json and the CLDR content required by the number and plural modules. Read CLDR content if you need more information.

You can use the static method Globalize.relativeTimeFormatter(), which uses the default locale.

var formatter;

Globalize.locale( "en" );
formatter = Globalize.relativeTimeFormatter( "month" );

formatter( 1 );
// > "next month"

formatter( 3 );
// > "in 3 months"

formatter( -1 );
// > "last month"

formatter( -3 );
// > "3 months ago"

You can use the instance method .relativeTimeFormatter(), which uses the instance locale.

var globalize = new Globalize( "en" ),
	formatter = globalize.relativeTimeFormatter( "week" );

formatter( 1 );
// > "next week"