CldrIntlService
The Internationalization service implemented by using
the CLDR Database via the @telerik/kendo-intl
package.
localeId
string
Gets or sets the current locale ID.
Constructors
CldrIntlService
(localeId: string)
Creates a new instance of the service with the ID of the specified locale.
Note that the parts of the locale ID can be separated by either _
(underscore)
or -
(dash).
Parameters
localeId
string
The default locale ID.
Methods
dateFieldName
Returns the date names from the current locale based on the option.
The available type
values are:
era
year
quarter
month
week
day
dayperiod
hour
minute
second
zone
The available nameType
values are:
wide
narrow
short
dateFieldName({ type: 'day' }); //returns 'day';
dateFieldName({ type: 'day', nameType: 'wide' }); //returns 'day';
dateFieldName({ type: 'month', nameType: 'short' }); //returns 'mo.';
dateFieldName({ type: 'month', nameType: 'wide' }); //returns 'month';
Parameters
options
Detailed configuration for the desired date field name.
localeId?
string
The locale ID to use in place of the default one. Optional.
Returns
string
- The day names from the current locale based on the option.
dateFormatNames
Returns a localized date field name based on specific dateFieldName options.
The available type values are:
day
dayperiod
months
quarters
eras
Parameters
options
Detailed configuration for the desired date format.
localeId?
string
The locale ID to use in place of the default one. Optional.
Returns
any
- The day names from the current locale based on the option.
firstDay
Returns the first day index starting from Sunday.
Parameters
localeId?
string
The locale ID. Defaults to the current locale ID.
Returns
number
- The index of the first day of the week (0 == Sunday).
format
Formats a string with placeholders such as
Total amount {0:c}
.
Parameters
format
string
The format string.
values
any[]
One or more values to output in the format string placeholders.
Returns
string
- The formatted string.
formatDate
Converts a Date
object into a string based on the specified format.
If no format is provided, the default short date format is used.
Parameters
value
Date
The date to format.
format?
String | DateFormatOptions
The format string or options.
localeId?
string
The locale ID to use in place of the default one. Optional.
Returns
string
The formatted date.
formatNumber
Converts a Number
into a string based on the specified format.
Parameters
value
number
The number to format.
format
string | NumberFormatOptions
The format string or options.
localeId?
string
The locale ID to use in place of the default one. Optional.
Returns
string
The formatted number.
notify
Notifies that the service was changed.
numberSymbols
Returns the number symbols from the current locale based on the option.
Parameters
localeId?
string
The locale ID to use in place of the default one. Optional.
Returns
any
- The number symbols from the current locale.
parseDate
Converts a string into a Date
object based on the specified format.
Parameters
value
string
The string to convert.
format?
string | DateFormatOptions | string[] | DateFormatOptions[]
The format strings or options.
localeId?
string
The locale ID to use in place of the default one. Optional.
Returns
Date
The parsed date.
parseNumber
Converts a string into a Number
.
Parameters
value
string
The string to convert.
format?
string | NumberFormatOptions
The format string or options.
localeId?
string
The locale ID to use in place of the default one. Optional.
Returns
number
The parsed number.
splitDateFormat
Splits the date format into objects containing information about each part of the pattern.
Parameters
format
string | DateFormatOptions
The format string or options.
localeId?
string
The optional locale id. If not specified, the "en"
locale id is used.
Returns
The date format parts.
toString
Converts an object into a string based on the specified format.
Parameters
value
any
The value to format.
format
string | any
The format to use.
localeId?
string
The locale ID to use in place of the default one. Optional.
Returns
string
The formatted object.
weekendRange
Returns the start and end index of the locale weekend starting from Sunday.
Parameters
localeId?
string
The locale ID. Defaults to the current locale ID.
Returns
- The the start and end index of the locale weekend (0 == Sunday).