Added in API level 3

Formatter


public final class Formatter
extends Object

java.lang.Object
   ↳ android.text.format.Formatter


Utility class to aid in formatting common values that are not covered by the Formatter class in java.util

Summary

Public constructors

Formatter()

Public methods

static String formatFileSize(Context context, long sizeBytes)

Formats a content size to be in the form of bytes, kilobytes, megabytes, etc.

static String formatIpAddress(int ipv4Address)

This method was deprecated in API level 15. Use InetAddress.getHostAddress(), which supports both IPv4 and IPv6 addresses. This method does not support IPv6 addresses.

static String formatShortFileSize(Context context, long sizeBytes)

Like formatFileSize(Context, long), but trying to generate shorter numbers (showing fewer digits of precision).

Inherited methods

Public constructors

Formatter

public Formatter ()

Public methods

formatFileSize

Added in API level 3
public static String formatFileSize (Context context, 
                long sizeBytes)

Formats a content size to be in the form of bytes, kilobytes, megabytes, etc.

As of O, the prefixes are used in their standard meanings in the SI system, so kB = 1000 bytes, MB = 1,000,000 bytes, etc.

In Build.VERSION_CODES.N and earlier, powers of 1024 are used instead, with KB = 1024 bytes, MB = 1,048,576 bytes, etc.

If the context has a right-to-left locale, the returned string is wrapped in bidi formatting characters to make sure it's displayed correctly if inserted inside a right-to-left string. (This is useful in cases where the unit strings, like "MB", are left-to-right, but the locale is right-to-left.)

Parameters
context Context: Context to use to load the localized units This value may be null.

sizeBytes long: size value to be formatted, in bytes

Returns
String formatted string with the number

formatIpAddress

Added in API level 3
Deprecated in API level 15
public static String formatIpAddress (int ipv4Address)

This method was deprecated in API level 15.
Use InetAddress.getHostAddress(), which supports both IPv4 and IPv6 addresses. This method does not support IPv6 addresses.

Returns a string in the canonical IPv4 format ###.###.###.### from a packed integer containing the IP address. The IPv4 address is expected to be in little-endian format (LSB first). That is, 0x01020304 will return "4.3.2.1".

Parameters
ipv4Address int

Returns
String

formatShortFileSize

Added in API level 5
public static String formatShortFileSize (Context context, 
                long sizeBytes)

Like formatFileSize(Context, long), but trying to generate shorter numbers (showing fewer digits of precision).

Parameters
context Context: This value may be null.

sizeBytes long

Returns
String