For example, returns a string like "Wednesday, May 25, 2016, 8:02PM" or "Chorshanba, 2016 * may 25,20:02". * *
For pre-N devices, the returned value may not start with a capital if the local convention
* is to not capitalize day names. On N+ devices, the returned value is always capitalized.
*/
public static CharSequence formatDate(Context context, long callDateMillis) {
CharSequence dateValue =
DateUtils.formatDateRange(
context,
callDateMillis /* startDate */,
callDateMillis /* endDate */,
DateUtils.FORMAT_SHOW_TIME
| DateUtils.FORMAT_SHOW_DATE
| DateUtils.FORMAT_SHOW_WEEKDAY
| DateUtils.FORMAT_SHOW_YEAR);
// We want the beginning of the date string to be capitalized, even if the word at the beginning
// of the string is not usually capitalized. For example, "Wednesdsay" in Uzbek is "chorshanba”
// (not capitalized). To handle this issue we apply title casing to the start of the sentence so
// that "chorshanba, 2016 may 25,20:02" becomes "Chorshanba, 2016 may 25,20:02".
//
// The ICU library was not available in Android until N, so we can only do this in N+ devices.
// Pre-N devices will still see incorrect capitalization in some languages.
if (VERSION.SDK_INT < VERSION_CODES.N) {
return dateValue;
}
// Using the ICU library is safer than just applying toUpperCase() on the first letter of the
// word because in some languages, there can be multiple starting characters which should be
// upper-cased together. For example in Dutch "ij" is a digraph in which both letters should be
// capitalized together.
// TITLECASE_NO_LOWERCASE is necessary so that things that are already capitalized like the
// month ("May") are not lower-cased as part of the conversion.
return UCharacter.toTitleCase(
Locale.getDefault(),
dateValue.toString(),
BreakIterator.getSentenceInstance(),
UCharacter.TITLECASE_NO_LOWERCASE);
}
private static CharSequence formatDuration(Context context, long elapsedSeconds) {
Resources res = context.getResources();
String formatPattern;
if (elapsedSeconds >= 60) {
String minutesString = res.getString(R.string.call_details_minutes_abbreviation);
String secondsString = res.getString(R.string.call_details_seconds_abbreviation);
// example output: "1m 1s"
formatPattern =
context.getString(
R.string.call_duration_format_pattern, "m", minutesString, "s", secondsString);
} else {
String secondsString = res.getString(R.string.call_details_seconds_abbreviation);
// example output: "1s"
formatPattern =
context.getString(R.string.call_duration_short_format_pattern, "s", secondsString);
}
SimpleDateFormat format = new SimpleDateFormat(formatPattern);
return format.format(new Date(TimeUnit.SECONDS.toMillis(elapsedSeconds)));
}
private static CharSequence formatDurationA11y(Context context, long elapsedSeconds) {
Resources res = context.getResources();
if (elapsedSeconds >= 60) {
int minutes = (int) (elapsedSeconds / 60);
int seconds = (int) elapsedSeconds - minutes * 60;
String minutesString = res.getQuantityString(R.plurals.a11y_minutes, minutes);
String secondsString = res.getQuantityString(R.plurals.a11y_seconds, seconds);
// example output: "1 minute 1 second", "2 minutes 2 seconds", ect.
return context.getString(
R.string.a11y_call_duration_format, minutes, minutesString, seconds, secondsString);
} else {
String secondsString = res.getQuantityString(R.plurals.a11y_seconds, (int) elapsedSeconds);
// example output: "1 second", "2 seconds"
return context.getString(
R.string.a11y_call_duration_short_format, elapsedSeconds, secondsString);
}
}
/**
* Formats a string containing the call duration and the data usage (if specified).
*
* @param elapsedSeconds Total elapsed seconds.
* @param dataUsage Data usage in bytes, or null if not specified.
* @return String containing call duration and data usage.
*/
public static CharSequence formatDurationAndDataUsage(
Context context, long elapsedSeconds, long dataUsage) {
return formatDurationAndDataUsageInternal(
context, formatDuration(context, elapsedSeconds), dataUsage);
}
/**
* Formats a string containing the call duration and the data usage (if specified) for TalkBack.
*
* @param elapsedSeconds Total elapsed seconds.
* @param dataUsage Data usage in bytes, or null if not specified.
* @return String containing call duration and data usage.
*/
public static CharSequence formatDurationAndDataUsageA11y(
Context context, long elapsedSeconds, long dataUsage) {
return formatDurationAndDataUsageInternal(
context, formatDurationA11y(context, elapsedSeconds), dataUsage);
}
private static CharSequence formatDurationAndDataUsageInternal(
Context context, CharSequence duration, long dataUsage) {
List