namespace anychart.format Improve this Doc

The anychart.format namespace contains different static functions for format of texts, dates, numbers, etc.

Constants Overview


locales	Contains a list of the used localizations.

Functions Overview


date()	Formats date by pattern.
dateTime()	Formats date time by the pattern.
getDateTimeFormat()	Gets date time format from locale by identifier and index.
getDateTimeFormats()	Gets all date time formats from locale by identifier.
getIntervalIdentifier()	Gets interval identifier by unit name.
getMessage()	Returns localized message if the translation is provided in messages section of output locale.
inputBaseDate()	Input base date settings.
inputDateTimeFormat()	Input date time format
inputLocale()	Input format settings to be used.
number()	Formats number.
outputDateFormat()	Output date format settings to be used.
outputDateTimeFormat()	Output date time format settings to be used.
outputLocale()	Output format settings to be used.
outputTimeFormat()	Output time format settings to be used.
outputTimezone()	Output timezone settings.
parseDateTime()	Parses input value to date.
parseNumber()	Parses a value to number according to locale set.
subs()	Formats for string substitution.
time()	Formats time by pattern.

Typedefs Overview


anychart.format.DateTimeLocale	Type definition for date time localization.
anychart.format.Locale	Type definition for localization.
anychart.format.NumberLocale	Type definition for number locale.

Classes Overview


anychart.format.Context	The Context class contains methods to show some information from extra fields in the format function context.

Constants Description

localesSince version 7.9.0

Contains a list of the used localizations.
By default contains localization "en-en". See the full localizations list by link.
The field can contain a few localizations. See samples below.
Anychart.format.locales map accepts keys (localization names) or an object with settings from anychart.format.Locale.

Keys	Object
"af-za"	{dateTimeLocale: { 'eras': ['v.C.', 'n.C.'], 'eraNames': ['voor Christus', 'na Christus'], } numberLocale: { 'decimalsCount': 3, 'decimalPoint': ':' }

Type: Object.anychart.format.Locale>

Try it:

Functions Description

date

date(date, timeZone, locale)

Formats date by pattern.
The same that anychart.format.dateTime but with the anychart.format#outputDateFormat as default datetime format.

Params:

Name	Type	Description
date	number \| Date	UTC timestamp or Date object.
timeZone	number	Adjust with time zone. Indicate minutes WEST of UTC to be used as a constant time zone offset.
locale	string \| anychart.format.Locale	Locale to be used.

Returns:

string - Formatted value.

Try it:

Usage sample

dateTime

dateTime(date, format, timeZone, locale)Since version 7.8.0

Formats date time by the pattern.

Params:

Name	Type	Description
date	number \| Date	UTC timestamp or Date object.
format	string	Format of date ['yyyy.MM.dd'].
timeZone	number	Adjust with time zone. Indicate minutes WEST of UTC to be used as a constant time zone offset.
locale	string \| anychart.format.Locale	Locale to be used.

Returns:

string - Formatted value.

Try it:

Usage sample

getDateTimeFormat

getDateTimeFormat(identifier, index, locale)

Gets date time format from locale by identifier and index. To get all formats use anychart.format#getDateTimeFormats.

Params:

Name	Type	Default	Description
identifier	string		Use anychart.format#getIntervalIdentifier to get correct identifier.
index	number	0	If locale has more than one format.
locale	anychart.format.Locale		Locale to be used.

Returns:

string -

See listing

Use anychart.format.getDateTimeFormat
// for example in 'de-de' locale defined
// 'year_day': ['EEEE, y MMMM dd', 'yy MM dd', 'yyyy MMMM dd']
var identifier = anychart.format.getIntervalIdentifier('days','years');
var format = anychart.format.getDateTimeFormat(identifier, 2, 'de-de');
// format = 'yyyy MMMM dd'

getDateTimeFormats

getDateTimeFormats(identifier, locale)Since version 7.12.0

Gets all date time formats from locale by identifier.
To get one format by index use anychart.format#getDateTimeFormat.

Params:

Name	Type	Description
identifier	string	Use anychart.format#getIntervalIdentifier to get correct identifier
locale	anychart.format.Locale	Locale to be used.

Returns:

string -

See listing

Use anychart.format.getDateTimeFormat
// for example in 'de-de' locale defined
// 'year_day': ['EEEE, y MMMM dd', 'yy MM dd', 'yyyy MMMM dd']
var identifier = anychart.format.getIntervalIdentifier('days','years');
var allFormats = anychart.format.getDateTimeFormat(identifier, 'de-de');
// allFormats = ['EEEE, y MMMM dd', 'yy MM dd', 'yyyy MMMM dd']

getIntervalIdentifier

getIntervalIdentifier(intervalUnit, parentIntervalUnit)Since version 7.12.0

Gets interval identifier by unit name.

Params:

Name	Type	Description
intervalUnit	anychart.enums.Interval \| string	Name of unit interval.
parentIntervalUnit	anychart.enums.Interval \| string	Name of parent unit interval.

Returns:

string - Correct interval identifier by unit name.

See listing

Use anychart.format.getIntervalIdentifier
anychart.format.getIntervalIdentifier('day','year');
anychart.format.getIntervalIdentifier('d','y');
// returns 'year_day'

getMessage

getMessage(keyword)Since version 7.12.0

Returns localized message if the translation is provided in messages section of output locale.

Params:

Name	Type	Description
keyword	string	Keyword.

Returns:

string - Message from current locale by keyword or a keyword itself if a message doesn't exist.

Try it:

Usage sample

inputBaseDate

inputBaseDate()Since version 7.12.0

Getter for the input base date.

Returns:

Date - The input base date.Date -

inputBaseDate(date)Since version 7.12.0

Setter for the input base date.

Detailed description

All dates are parsed by the anychart.format.parseDate in case of lacking any date time parts like year or month is used parts of this base date.
Defaults to the first millisecond of current UTC month.

Params:

Name	Type	Description
date	Date \| number	Date to set.

Returns:

Date - The input base date.

See listing

anychart.format.inputBaseDate(Date.UTC(2010, 10, 15, 16, 23, 10, 113));
// Try to parse
anychart.format.parseDateTime("13:31:16", "HH:mm:ss");
// Returns Date.UTC(2010, 10, 15, 13, 31, 16, 113)

Try it:

Usage sample

inputDateTimeFormat

inputDateTimeFormat()Since version 7.9.0

Getter for the input date time format.

Detailed description

This method can be used as getter only if the value has been previously set.

Returns:

string - The date time format.

See listing

var dateTimeFormat = anychart.format.inputDateTimeFormat();

inputDateTimeFormat(format)Since version 7.9.0

Setter for the input date time format. Has priority over the format of localization.

Params:

Name	Type	Description
format	string	Input date time format for parsing

Returns:

string - The date time format.

Try it:

Usage sample

inputLocale

inputLocale()Since version 7.9.0

Getter for input format settings.

Returns:

string | anychart.format.Locale - The localization name or settings.

See listing

var inputLocale = anychart.format.inputLocale();

inputLocale(settings)Since version 7.9.0

Setter for input format settings.

Params:

Name	Type	Default	Description
settings	string \| anychart.format.Locale	'default'	Localization name or settings.

Returns:

string | anychart.format.Locale - The localization name or settings.

Try it:

Usage sample

number

number(number, decimalsCountOrLocal, decimalPoint, groupsSeparator, scale, zeroFillDecimals, scaleSuffixSeparator, useBracketsForNegative)Since version 7.8.0

Formats a number with given settings.

Params:

Name	Type	Default	Description
number	number		Number for formatting.
decimalsCountOrLocal	number \| anychart.format.NumberLocale \| string	2	Desired number of decimals or localization.
decimalPoint	string	"."	String to modify the decimal separator.
groupsSeparator	string	""	String to separate every three digits.
scale	Object \| boolean	false	Automatic scaling (divides by factor and substitutes suffix). If pass "true", will be used default scale.
zeroFillDecimals	boolean	false	Whether to fill in the remaining decimal places zeros.
scaleSuffixSeparator	string	""	Additive between the suffix of scale and the number. Works only with scaling.
useBracketsForNegative	boolean		Whether to use brackets for negative value.

Returns:

string - Formatted value.

Try it:

Usage sample

number(number, settings)Since version 7.8.0

Formats a number using object.

Params:

Name	Type	Description
number	number	Number for formatting.
settings	anychart.format.NumberLocale	Object with settings.

Returns:

string - Formatted value.

Try it:

Usage sample

outputDateFormat

outputDateFormat()Since version 7.12.0

Getter for the only current output date format.

Detailed description

Has priority over the localization format.
NOTE: does not depend on anychart.format#outputDateTimeFormat.
Priority to return date format:

Value from the setter
Value from the 'dateFormat' field in the outputLocale
Value from the 'dateFormat' field in the default locale
'yyyy.MM.dd'

Returns:

string - The output date format.

outputDateFormat(format)Since version 7.12.0

Setter for the only output date format.

Params:

Name	Type	Description
format	string	Date format for parsing.

Try it:

Usage sample

outputDateTimeFormat

outputDateTimeFormat()Since version 7.9.0

Getter for the output date and time format.

Detailed description

Has priority over the format of localization.
Priority to return date format:

Value from setter
Value from field 'dateTimeFormat' in outputLocale
Value from field 'dateTimeFormat' in default locale
'yyyy.MM.dd'

Returns:

string - The date time format.

outputDateTimeFormat(format)Since version 7.9.0

Output date and time format. Has priority over the format of localization.

Params:

Name	Type	Description
format	string	Date time format for parsing.

Try it:

Usage sample

outputLocale

outputLocale()Since version 7.9.0

Getter for output format settings.

Returns:

string | anychart.format.Locale - The localization name or settings.

See listing

var outputLocale = anychart.format.outputLocale();

outputLocale(settings)Since version 7.9.0

Setter for output format settings.

Params:

Name	Type	Description
settings	string \| anychart.format.Locale	Localization name (from anychart.format#locales) or object of localization for output.

Returns:

string | anychart.format.Locale - The localization name or settings.

Try it:

Usage sample

outputTimeFormat

outputTimeFormat()Since version 7.12.0

Getter for the only current output time format.

Detailed description

Has priority over the format of localization.
NOTE: independed from anychart.format#outputDateTimeFormat.
Priority to return date format:

Value from setter
Value from field 'timeFormat' in outputLocale
Value from field 'timeFormat' in default locale
'HH:mm:ss'

Returns:

string - The current time format.

outputTimeFormat(format)Since version 7.12.0

Setter for the only output time format.

Params:

Name	Type	Description
format	string	Time format for parsing

Try it:

Usage sample

outputTimezone

outputTimezone()Since version 7.9.0

Getter for the output offset.

Returns:

number - The output offset.

See listing

var outputTimezone = anychart.format.outputTimezone();

outputTimezone(value)Since version 7.9.0

Setter for the output offset.
Adjusts time zone by value in minutes. Indicate minutes WEST of UTC to be used as the constant time zone offset.

Params:

Name	Type	Default	Description
value	number	0	Value for adjusting time zone in minutes.

Returns:

number - The output offset.

Try it:

Usage sample

parseDateTime

parseDateTime(value, format, baseDate, locale)Since version 7.9.0

Parses input value to date.

Params:

Name	Type	Description
value	*	Input value.
format	string	Format to be parsed. If undefined, anychart.format.inputDateTimeFormat is be used.
baseDate	Date	Date object to hold the parsed date. Used when input value doesn't contain information about a year or a month or else. If parsing is successful this object contains absolutely the same values of date time units as the return value. NOTE: If not Date, Date.UTC(currentYear, currentMoth) is be used.
locale	string \| anychart.format.Locale	Locale to be used. If not set, anychart.format.inputLocale is be used.

Returns:

Date - Parsed date or null if got wrong input value.

Try it:

Usage sample

parseNumber

parseNumber(value, locale)Since version 7.9.0

Parses a value to number according to locale set.

Params:

Name	Type	Description
value	*	Value to be parsed.
locale	anychart.format.NumberLocale \| string	Number locale to be used. If not defined, anychart.format.input.numberFormat will be used.

Returns:

number - Parsed value. NaN if value could not be parsed.

Try it:

Usage sample

subs

subs(string, var_args)Since version 7.8.0

Formats for string substitution. For example: subs("foo%s hot%s", "bar", "dog") becomes "foobar hotdog".

Params:

Name	Type	Description
string	string	The string containing the pattern.
var_args	*	The items to substitute into the pattern.

Returns:

string - A copy of {@code str} in which each occurrence of {@code %s} has been replaced an argument from {@code var_args}.

Try it:

Usage sample

time

time(date, timeZone, locale)

Formats time by pattern.
The same that anychart.format.dateTime but with the anychart.format#outputTimeFormat as default datetime format.

Params:

Name	Type	Description
date	number \| Date	UTC timestamp or Date object.
timeZone	number	Adjust with time zone. Indicate minutes WEST of UTC to be used as a constant time zone offset.
locale	string \| anychart.format.Locale	Locale to be used.

Returns:

string - Formatted value.

Try it:

Usage sample