1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
/*
* Copyright (C) 2017 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 com.android.dialer.calllogutils;
import android.content.Context;
import android.icu.lang.UCharacter;
import android.icu.text.BreakIterator;
import android.os.Build.VERSION;
import android.os.Build.VERSION_CODES;
import android.text.format.DateUtils;
import android.text.format.Formatter;
import com.android.dialer.util.DialerUtils;
import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
/** Utility class for formatting data and data usage in call log entries. */
public class CallEntryFormatter {
/**
* Formats the provided date into a value suitable for display in the current locale.
*
* <p>For example, returns a string like "Wednesday, May 25, 2016, 8:02PM" or "Chorshanba, 2016
* may 25,20:02".
*
* <p>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, boolean a11y) {
long minutes = 0;
long seconds = 0;
if (elapsedSeconds >= 60) {
minutes = elapsedSeconds / 60;
elapsedSeconds -= minutes * 60;
seconds = elapsedSeconds;
int stringId =
a11y ? R.string.call_details_duration_format_a11y : R.string.call_details_duration_format;
return context.getString(stringId, minutes, seconds);
} else {
seconds = elapsedSeconds;
int stringId =
a11y
? R.string.call_details_short_duration_format_a11y
: R.string.call_details_short_duration_format;
return context.getString(stringId, seconds);
}
}
/**
* 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.
* @param a11y {@code true} if string should be talk back friendly.
* @return String containing call duration and data usage.
*/
public static CharSequence formatDurationAndDataUsage(
Context context, long elapsedSeconds, long dataUsage, boolean a11y) {
CharSequence duration = formatDuration(context, elapsedSeconds, a11y);
List<CharSequence> durationItems = new ArrayList<>();
if (dataUsage > 0) {
durationItems.add(duration);
durationItems.add(Formatter.formatShortFileSize(context, dataUsage));
return DialerUtils.join(durationItems);
} else {
return duration;
}
}
}
|