The StringConverter class allows you to convert arbitrary values into strings.
Description
The StringConverter class allows you to convert arbitrary values into strings using the following extended conversion rules:
- Numbers: are converted with ‘.’ as decimal point
- DateTime: using the ISO format
- Boolean: “true” for true and “false” for false
- Arrays: as comma-separated list
- Other objects: using toString() method
Static methods
toNullableString
Converts a value into a string or returns null when the value is null.
public static
toNullableString(value: any): string
- value: any - value to convert.
- returns: string - string value or null when value is null.
toString
Converts a value into string or returns "" when the value is null.
public static
toString(value: any): string
- value: any - value to convert.
- returns: string - string value or "" when value is null.
toStringWithDefault
Converts a value into a string or returns a given default when the value is null.
public static
toStringWithDefault(value: any, defaultValue: string): string
- value: any - value to convert.
- defaultValue: string - default value.
- returns: string - string value or given default when value is null.
Examples
let value1 = StringConverter.ToString(123.456); // Result: "123.456"
let value2 = StringConverter.ToString(true); // Result: "true"
let value3 = StringConverter.ToString(new Date(2018,0,1)); // Result: "2018-01-01T00:00:00.00"
let value4 = StringConverter.ToString([1,2,3]); // Result: "1,2,3"