o

Format the given number to nearest 10ⁿ (rounded to thousands) in the default pattern of the given locale, suffixed with a space, the metric unit prefix (k, M, G, T, P or E) and the given unit, rounding half up with a precision of 3 digits, whereafter trailing zeroes in fraction part are stripped. For example (with English locale and unit B):

• 999 will appear as 999 B
• 1000 will appear as 1 kB
• 1004 will appear as 1 kB
• 1005 will appear as 1.01 kB
• 1594 will appear as 1.59 kB
• 1595 will appear as 1.6 kB
• 9000 will appear as 9 kB
• 9900 will appear as 9.9 kB
• 9994 will appear as 9.99 kB
• 9995 will appear as 10 kB
• 99990 will appear as 100 kB
• 9994999 will appear as 9.99 MB
• 9995000 will appear as 10 MB

The given locale can be a Locale object or a string representation. If the value is null, NaN or infinity, then this will return null.