/*
* Copyright (C) 2006 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.text.format;
import android.content.Context;
import android.net.NetworkUtils;
/**
* Utility class to aid in formatting common values that are not covered
* by the {@link java.util.Formatter} class in {@link java.util}
*/
public final class Formatter {
/**
* Formats a content size to be in the form of bytes, kilobytes, megabytes, etc
*
* @param context Context to use to load the localized units
* @param number size value to be formatted
* @return formatted string with the number
*/
public static String formatFileSize(Context context, long number) {
return formatFileSize(context, number, false);
}
/**
* Like {@link #formatFileSize}, but trying to generate shorter numbers
* (showing fewer digits of precision).
*/
public static String formatShortFileSize(Context context, long number) {
return formatFileSize(context, number, true);
}
private static String formatFileSize(Context context, long number, boolean shorter) {
if (context == null) {
return "";
}
float result = number;
int suffix = com.android.internal.R.string.byteShort;
if (result > 900) {
suffix = com.android.internal.R.string.kilobyteShort;
result = result / 1024;
}
if (result > 900) {
suffix = com.android.internal.R.string.megabyteShort;
result = result / 1024;
}
if (result > 900) {
suffix = com.android.internal.R.string.gigabyteShort;
result = result / 1024;
}
if (result > 900) {
suffix = com.android.internal.R.string.terabyteShort;
result = result / 1024;
}
if (result > 900) {
suffix = com.android.internal.R.string.petabyteShort;
result = result / 1024;
}
String value;
if (result < 1) {
value = String.format("%.2f", result);
} else if (result < 10) {
if (shorter) {
value = String.format("%.1f", result);
} else {
value = String.format("%.2f", result);
}
} else if (result < 100) {
if (shorter) {
value = String.format("%.0f", result);
} else {
value = String.format("%.2f", result);
}
} else {
value = String.format("%.0f", result);
}
return context.getResources().
getString(com.android.internal.R.string.fileSizeSuffix,
value, context.getString(suffix));
}
/**
* 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".
*
* @deprecated Use {@link java.net.InetAddress#getHostAddress()}, which supports both IPv4 and
* IPv6 addresses. This method does not support IPv6 addresses.
*/
@Deprecated
public static String formatIpAddress(int ipv4Address) {
return NetworkUtils.intToInetAddress(ipv4Address).getHostAddress();
}
private static final int SECONDS_PER_MINUTE = 60;
private static final int SECONDS_PER_HOUR = 60 * 60;
private static final int SECONDS_PER_DAY = 24 * 60 * 60;
private static final int MILLIS_PER_MINUTE = 1000 * 60;
/**
* Returns elapsed time for the given millis, in the following format:
* 1 day 5 hrs; will include at most two units, can go down to seconds precision.
* @param context the application context
* @param millis the elapsed time in milli seconds
* @return the formatted elapsed time
* @hide
*/
public static String formatShortElapsedTime(Context context, long millis) {
long secondsLong = millis / 1000;
int days = 0, hours = 0, minutes = 0;
if (secondsLong >= SECONDS_PER_DAY) {
days = (int)(secondsLong / SECONDS_PER_DAY);
secondsLong -= days * SECONDS_PER_DAY;
}
if (secondsLong >= SECONDS_PER_HOUR) {
hours = (int)(secondsLong / SECONDS_PER_HOUR);
secondsLong -= hours * SECONDS_PER_HOUR;
}
if (secondsLong >= SECONDS_PER_MINUTE) {
minutes = (int)(secondsLong / SECONDS_PER_MINUTE);
secondsLong -= minutes * SECONDS_PER_MINUTE;
}
int seconds = (int)secondsLong;
if (days >= 2) {
days += (hours+12)/24;
return context.getString(com.android.internal.R.string.durationDays, days);
} else if (days > 0) {
if (hours == 1) {
return context.getString(com.android.internal.R.string.durationDayHour, days, hours);
}
return context.getString(com.android.internal.R.string.durationDayHours, days, hours);
} else if (hours >= 2) {
hours += (minutes+30)/60;
return context.getString(com.android.internal.R.string.durationHours, hours);
} else if (hours > 0) {
if (minutes == 1) {
return context.getString(com.android.internal.R.string.durationHourMinute, hours,
minutes);
}
return context.getString(com.android.internal.R.string.durationHourMinutes, hours,
minutes);
} else if (minutes >= 2) {
minutes += (seconds+30)/60;
return context.getString(com.android.internal.R.string.durationMinutes, minutes);
} else if (minutes > 0) {
if (seconds == 1) {
return context.getString(com.android.internal.R.string.durationMinuteSecond, minutes,
seconds);
}
return context.getString(com.android.internal.R.string.durationMinuteSeconds, minutes,
seconds);
} else if (seconds == 1) {
return context.getString(com.android.internal.R.string.durationSecond, seconds);
} else {
return context.getString(com.android.internal.R.string.durationSeconds, seconds);
}
}
/**
* Returns elapsed time for the given millis, in the following format:
* 1 day 5 hrs; will include at most two units, can go down to minutes precision.
* @param context the application context
* @param millis the elapsed time in milli seconds
* @return the formatted elapsed time
* @hide
*/
public static String formatShortElapsedTimeRoundingUpToMinutes(Context context, long millis) {
long minutesRoundedUp = (millis + MILLIS_PER_MINUTE - 1) / MILLIS_PER_MINUTE;
if (minutesRoundedUp == 0) {
return context.getString(com.android.internal.R.string.durationMinutes, 0);
} else if (minutesRoundedUp == 1) {
return context.getString(com.android.internal.R.string.durationMinute, 1);
}
return formatShortElapsedTime(context, minutesRoundedUp * MILLIS_PER_MINUTE);
}
}
|
