19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.text.format; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport com.android.internal.R; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.res.Configuration; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.res.Resources; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.Calendar; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.Date; 27becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chanimport java.util.Formatter; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.GregorianCalendar; 29becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chanimport java.util.Locale; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.TimeZone; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 324af85345e798c37ab026e93a1ae250d8bca4fc40Elliott Hughesimport libcore.icu.LocaleData; 334af85345e798c37ab026e93a1ae250d8bca4fc40Elliott Hughes 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class contains various date-related utilities for creating text for things like 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * elapsed time and date ranges, strings for days of the week and months, and AM/PM text etc. 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class DateUtils 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final Object sLock = new Object(); 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static Configuration sLastConfig; 425bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer private static java.text.DateFormat sStatusTimeFormat; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String sElapsedFormatMMSS; 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String sElapsedFormatHMMSS; 4599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String FAST_FORMAT_HMMSS = "%1$d:%2$02d:%3$02d"; 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String FAST_FORMAT_MMSS = "%1$02d:%2$02d"; 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final char TIME_SEPARATOR = ':'; 4999a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final long SECOND_IN_MILLIS = 1000; 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final long MINUTE_IN_MILLIS = SECOND_IN_MILLIS * 60; 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final long HOUR_IN_MILLIS = MINUTE_IN_MILLIS * 60; 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final long DAY_IN_MILLIS = HOUR_IN_MILLIS * 24; 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final long WEEK_IN_MILLIS = DAY_IN_MILLIS * 7; 5684c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer /** 5784c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * This constant is actually the length of 364 days, not of a year! 5884c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer */ 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final long YEAR_IN_MILLIS = WEEK_IN_MILLIS * 52; 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The following FORMAT_* symbols are used for specifying the format of 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // dates and times in the formatDateRange method. 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_SHOW_TIME = 0x00001; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_SHOW_WEEKDAY = 0x00002; 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_SHOW_YEAR = 0x00004; 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_NO_YEAR = 0x00008; 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_SHOW_DATE = 0x00010; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_NO_MONTH_DAY = 0x00020; 69d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_12HOUR = 0x00040; 71d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_24HOUR = 0x00080; 73d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_CAP_AMPM = 0x00100; 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_NO_NOON = 0x00200; 76d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_CAP_NOON = 0x00400; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_NO_MIDNIGHT = 0x00800; 79d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_CAP_MIDNIGHT = 0x01000; 81577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik /** 82577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @deprecated Use 83577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * {@link #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange} 84577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * and pass in {@link Time#TIMEZONE_UTC Time.TIMEZONE_UTC} for the timeZone instead. 85577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik */ 86577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik @Deprecated 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_UTC = 0x02000; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_ABBREV_TIME = 0x04000; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_ABBREV_WEEKDAY = 0x08000; 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_ABBREV_MONTH = 0x10000; 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_NUMERIC_DATE = 0x20000; 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_ABBREV_RELATIVE = 0x40000; 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_ABBREV_ALL = 0x80000; 94d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_CAP_NOON_MIDNIGHT = (FORMAT_CAP_NOON | FORMAT_CAP_MIDNIGHT); 96d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FORMAT_NO_NOON_MIDNIGHT = (FORMAT_NO_NOON | FORMAT_NO_MIDNIGHT); 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Date and time format strings that are constant and don't need to be 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // translated. 10184c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer /** 10284c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * This is not actually the preferred 24-hour date format in all locales. 103d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 10484c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer */ 105d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String HOUR_MINUTE_24 = "%H:%M"; 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String MONTH_FORMAT = "%B"; 1085669ce59aad19f17e1e89913e7483fb93b8aa0cfEric Fischer /** 1095669ce59aad19f17e1e89913e7483fb93b8aa0cfEric Fischer * This is not actually a useful month name in all locales. 110d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 1115669ce59aad19f17e1e89913e7483fb93b8aa0cfEric Fischer */ 112d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ABBREV_MONTH_FORMAT = "%b"; 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NUMERIC_MONTH_FORMAT = "%m"; 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String MONTH_DAY_FORMAT = "%-d"; 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String YEAR_FORMAT = "%Y"; 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String YEAR_FORMAT_TWO_DIGITS = "%g"; 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WEEKDAY_FORMAT = "%A"; 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ABBREV_WEEKDAY_FORMAT = "%a"; 12099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This table is used to lookup the resource string id of a format string 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // used for formatting a start and end date that fall in the same year. 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The index is constructed from a bit-wise OR of the boolean values: 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // {showTime, showYear, showWeekDay}. For example, if showYear and 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // showWeekDay are both true, then the index would be 3. 126d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes /** @deprecated do not use. */ 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int sameYearTable[] = { 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_year_md1_md2, 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_year_wday1_md1_wday2_md2, 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_year_mdy1_mdy2, 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_year_wday1_mdy1_wday2_mdy2, 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_year_md1_time1_md2_time2, 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_year_wday1_md1_time1_wday2_md2_time2, 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_year_mdy1_time1_mdy2_time2, 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_year_wday1_mdy1_time1_wday2_mdy2_time2, 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Numeric date strings 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_md1_md2, 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_wday1_md1_wday2_md2, 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_mdy1_mdy2, 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_wday1_mdy1_wday2_mdy2, 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_md1_time1_md2_time2, 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_wday1_md1_time1_wday2_md2_time2, 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_mdy1_time1_mdy2_time2, 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_wday1_mdy1_time1_wday2_mdy2_time2, 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 14799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This table is used to lookup the resource string id of a format string 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // used for formatting a start and end date that fall in the same month. 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The index is constructed from a bit-wise OR of the boolean values: 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // {showTime, showYear, showWeekDay}. For example, if showYear and 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // showWeekDay are both true, then the index would be 3. 153d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes /** @deprecated do not use. */ 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int sameMonthTable[] = { 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_month_md1_md2, 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_month_wday1_md1_wday2_md2, 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_month_mdy1_mdy2, 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_month_wday1_mdy1_wday2_mdy2, 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_month_md1_time1_md2_time2, 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_month_wday1_md1_time1_wday2_md2_time2, 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_month_mdy1_time1_mdy2_time2, 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.same_month_wday1_mdy1_time1_wday2_mdy2_time2, 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_md1_md2, 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_wday1_md1_wday2_md2, 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_mdy1_mdy2, 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_wday1_mdy1_wday2_mdy2, 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_md1_time1_md2_time2, 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_wday1_md1_time1_wday2_md2_time2, 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_mdy1_time1_mdy2_time2, 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project com.android.internal.R.string.numeric_wday1_mdy1_time1_wday2_mdy2_time2, 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request the full spelled-out name. For use with the 'abbrev' parameter of 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getDayOfWeekString} and {@link #getMonthString}. 17799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @more <p> 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * e.g. "Sunday" or "January" 180d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 182d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LENGTH_LONG = 10; 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request an abbreviated version of the name. For use with the 'abbrev' 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameter of {@link #getDayOfWeekString} and {@link #getMonthString}. 18899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @more <p> 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * e.g. "Sun" or "Jan" 191d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 193d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LENGTH_MEDIUM = 20; 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request a shorter abbreviated version of the name. 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For use with the 'abbrev' parameter of {@link #getDayOfWeekString} and {@link #getMonthString}. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @more 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>e.g. "Su" or "Jan" 2015bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * <p>In most languages, the results returned for LENGTH_SHORT will be the same as 2025bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * the results returned for {@link #LENGTH_MEDIUM}. 203d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 205d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LENGTH_SHORT = 30; 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request an even shorter abbreviated version of the name. 2105bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * Do not use this. Currently this will always return the same result 2115bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * as {@link #LENGTH_SHORT}. 212d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 214d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LENGTH_SHORTER = 40; 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request an even shorter abbreviated version of the name. 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For use with the 'abbrev' parameter of {@link #getDayOfWeekString} and {@link #getMonthString}. 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @more 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>e.g. "S", "T", "T" or "J" 2225bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * <p>In some languages, the results returned for LENGTH_SHORTEST will be the same as 2235bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * the results returned for {@link #LENGTH_SHORT}. 224d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 226d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LENGTH_SHORTEST = 50; 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a string for the day of the week. 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dayOfWeek One of {@link Calendar#SUNDAY Calendar.SUNDAY}, 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Calendar#MONDAY Calendar.MONDAY}, etc. 2335bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * @param abbrev One of {@link #LENGTH_LONG}, {@link #LENGTH_SHORT}, 2345bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * {@link #LENGTH_MEDIUM}, or {@link #LENGTH_SHORTEST}. 2355bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * Note that in most languages, {@link #LENGTH_SHORT} 2365bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * will return the same as {@link #LENGTH_MEDIUM}. 2375bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * Undefined lengths will return {@link #LENGTH_MEDIUM} 2385bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * but may return something different in the future. 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IndexOutOfBoundsException if the dayOfWeek is out of bounds. 240d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 242d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String getDayOfWeekString(int dayOfWeek, int abbrev) { 24408153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes LocaleData d = LocaleData.get(Locale.getDefault()); 24508153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes String[] names; 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (abbrev) { 24708153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_LONG: names = d.longWeekdayNames; break; 24808153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_MEDIUM: names = d.shortWeekdayNames; break; 24908153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_SHORT: names = d.shortWeekdayNames; break; // TODO 25008153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_SHORTER: names = d.shortWeekdayNames; break; // TODO 25108153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_SHORTEST: names = d.tinyWeekdayNames; break; 25208153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes default: names = d.shortWeekdayNames; break; 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 25408153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes return names[dayOfWeek]; 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a localized string for AM or PM. 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ampm Either {@link Calendar#AM Calendar.AM} or {@link Calendar#PM Calendar.PM}. 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IndexOutOfBoundsException if the ampm is out of bounds. 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Localized version of "AM" or "PM". 262d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 264d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String getAMPMString(int ampm) { 2664af85345e798c37ab026e93a1ae250d8bca4fc40Elliott Hughes return LocaleData.get(Locale.getDefault()).amPm[ampm - Calendar.AM]; 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2705bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * Return a localized string for the month of the year. 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param month One of {@link Calendar#JANUARY Calendar.JANUARY}, 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Calendar#FEBRUARY Calendar.FEBRUARY}, etc. 2735bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * @param abbrev One of {@link #LENGTH_LONG}, {@link #LENGTH_MEDIUM}, 2745bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * or {@link #LENGTH_SHORTEST}. 2755bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * Undefined lengths will return {@link #LENGTH_MEDIUM} 2765bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * but may return something different in the future. 2775bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * @return Localized month of the year. 278d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 280d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String getMonthString(int month, int abbrev) { 28208153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes // Note that here we use d.shortMonthNames for MEDIUM, SHORT and SHORTER. 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This is a shortcut to not spam the translators with too many variations 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // of the same string. If we find that in a language the distinction 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // is necessary, we can can add more without changing this API. 28608153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes LocaleData d = LocaleData.get(Locale.getDefault()); 28708153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes String[] names; 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (abbrev) { 28908153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_LONG: names = d.longMonthNames; break; 29008153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_MEDIUM: names = d.shortMonthNames; break; 29108153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_SHORT: names = d.shortMonthNames; break; 29208153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_SHORTER: names = d.shortMonthNames; break; 29308153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_SHORTEST: names = d.tinyMonthNames; break; 29408153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes default: names = d.shortMonthNames; break; 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 29608153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes return names[month]; 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3005bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * Return a localized string for the month of the year, for 3015bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * contexts where the month is not formatted together with 3025bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * a day of the month. 3035bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * 3045bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * @param month One of {@link Calendar#JANUARY Calendar.JANUARY}, 3055bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * {@link Calendar#FEBRUARY Calendar.FEBRUARY}, etc. 3065bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * @param abbrev One of {@link #LENGTH_LONG}, {@link #LENGTH_MEDIUM}, 3075bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * or {@link #LENGTH_SHORTEST}. 3085bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * Undefined lengths will return {@link #LENGTH_MEDIUM} 3095bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * but may return something different in the future. 3105bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * @return Localized month of the year. 3115bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer * @hide Pending API council approval 312d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes * @deprecated use {@link java.text.SimpleDateFormat} instead. 3135bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer */ 314d3c01012d8d329e541214e8207272ab5cc9ca004Elliott Hughes @Deprecated 3155bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer public static String getStandaloneMonthString(int month, int abbrev) { 31608153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes // Note that here we use d.shortMonthNames for MEDIUM, SHORT and SHORTER. 3175bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer // This is a shortcut to not spam the translators with too many variations 3185bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer // of the same string. If we find that in a language the distinction 3195bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer // is necessary, we can can add more without changing this API. 32008153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes LocaleData d = LocaleData.get(Locale.getDefault()); 32108153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes String[] names; 3225bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer switch (abbrev) { 32308153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_LONG: names = d.longStandAloneMonthNames; 3245bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer break; 32508153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_MEDIUM: names = d.shortMonthNames; break; 32608153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_SHORT: names = d.shortMonthNames; break; 32708153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_SHORTER: names = d.shortMonthNames; break; 32808153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes case LENGTH_SHORTEST: names = d.tinyMonthNames; break; 32908153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes default: names = d.shortMonthNames; break; 3305bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer } 33108153ee01e6aa67061f628bc3fed66c6400dfd1cElliott Hughes return names[month]; 3325bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer } 3335bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer 3345bd644caf73e76750feef1a82b8817d32f5367fcEric Fischer /** 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a string describing the elapsed time since startTime. 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startTime some time in the past. 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a String object containing the elapsed time. 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRelativeTimeSpanString(long, long, long) 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static CharSequence getRelativeTimeSpanString(long startTime) { 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getRelativeTimeSpanString(startTime, System.currentTimeMillis(), MINUTE_IN_MILLIS); 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a string describing 'time' as a time relative to 'now'. 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Time spans in the past are formatted like "42 minutes ago". 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Time spans in the future are formatted like "in 42 minutes". 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param time the time to describe, in milliseconds 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param now the current time in milliseconds 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param minResolution the minimum timespan to report. For example, a time 3 seconds in the 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * past will be reported as "0 minutes ago" if this is set to MINUTE_IN_MILLIS. Pass one of 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 0, MINUTE_IN_MILLIS, HOUR_IN_MILLIS, DAY_IN_MILLIS, WEEK_IN_MILLIS 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static CharSequence getRelativeTimeSpanString(long time, long now, long minResolution) { 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int flags = FORMAT_SHOW_DATE | FORMAT_SHOW_YEAR | FORMAT_ABBREV_MONTH; 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getRelativeTimeSpanString(time, now, minResolution, flags); 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a string describing 'time' as a time relative to 'now'. 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Time spans in the past are formatted like "42 minutes ago". Time spans in 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the future are formatted like "in 42 minutes". 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Can use {@link #FORMAT_ABBREV_RELATIVE} flag to use abbreviated relative 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * times, like "42 mins ago". 36999a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param time the time to describe, in milliseconds 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param now the current time in milliseconds 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param minResolution the minimum timespan to report. For example, a time 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3 seconds in the past will be reported as "0 minutes ago" if 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is set to MINUTE_IN_MILLIS. Pass one of 0, 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * MINUTE_IN_MILLIS, HOUR_IN_MILLIS, DAY_IN_MILLIS, 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WEEK_IN_MILLIS 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags a bit mask of formatting options, such as 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FORMAT_NUMERIC_DATE} or 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FORMAT_ABBREV_RELATIVE} 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static CharSequence getRelativeTimeSpanString(long time, long now, long minResolution, 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int flags) { 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Resources r = Resources.getSystem(); 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean abbrevRelative = (flags & (FORMAT_ABBREV_RELATIVE | FORMAT_ABBREV_ALL)) != 0; 38599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean past = (now >= time); 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long duration = Math.abs(now - time); 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resId; 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long count; 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (duration < MINUTE_IN_MILLIS && minResolution < MINUTE_IN_MILLIS) { 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project count = duration / SECOND_IN_MILLIS; 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (past) { 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevRelative) { 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.abbrev_num_seconds_ago; 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.num_seconds_ago; 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevRelative) { 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.abbrev_in_num_seconds; 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.in_num_seconds; 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (duration < HOUR_IN_MILLIS && minResolution < HOUR_IN_MILLIS) { 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project count = duration / MINUTE_IN_MILLIS; 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (past) { 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevRelative) { 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.abbrev_num_minutes_ago; 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.num_minutes_ago; 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevRelative) { 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.abbrev_in_num_minutes; 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.in_num_minutes; 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (duration < DAY_IN_MILLIS && minResolution < DAY_IN_MILLIS) { 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project count = duration / HOUR_IN_MILLIS; 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (past) { 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevRelative) { 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.abbrev_num_hours_ago; 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.num_hours_ago; 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevRelative) { 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.abbrev_in_num_hours; 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.in_num_hours; 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (duration < WEEK_IN_MILLIS && minResolution < WEEK_IN_MILLIS) { 4376a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques count = getNumberOfDaysPassed(time, now); 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (past) { 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevRelative) { 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.abbrev_num_days_ago; 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.num_days_ago; 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevRelative) { 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.abbrev_in_num_days; 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.in_num_days; 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // We know that we won't be showing the time, so it is safe to pass 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // in a null context. 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return formatDateRange(null, time, time, flags); 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String format = r.getQuantityString(resId, (int) count); 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return String.format(format, count); 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 46099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4626a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques * Returns the number of days passed between two dates. 4636a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques * 4646a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques * @param date1 first date 4656a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques * @param date2 second date 4666a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques * @return number of days passed between to dates. 4676a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques */ 4686a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques private synchronized static long getNumberOfDaysPassed(long date1, long date2) { 4696a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques if (sThenTime == null) { 4706a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sThenTime = new Time(); 4716a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } 4726a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sThenTime.set(date1); 4736a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques int day1 = Time.getJulianDay(date1, sThenTime.gmtoff); 4746a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sThenTime.set(date2); 4756a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques int day2 = Time.getJulianDay(date2, sThenTime.gmtoff); 4766a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques return Math.abs(day2 - day1); 4776a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } 4786a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques 4796a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques /** 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return string describing the elapsed time since startTime formatted like 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "[relative time/date], [time]". 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example output strings for the US date format. 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3 mins ago, 10:15 AM</li> 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>yesterday, 12:20 PM</li> 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Dec 12, 4:12 AM</li> 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>11/14/2007, 8:20 AM</li> 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 49099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param time some time in the past. 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param minResolution the minimum elapsed time (in milliseconds) to report 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when showing relative times. For example, a time 3 seconds in 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the past will be reported as "0 minutes ago" if this is set to 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #MINUTE_IN_MILLIS}. 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param transitionResolution the elapsed time (in milliseconds) at which 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to stop reporting relative measurements. Elapsed times greater 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * than this resolution will default to normal date formatting. 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, will transition from "6 days ago" to "Dec 12" 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when using {@link #WEEK_IN_MILLIS}. 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static CharSequence getRelativeDateTimeString(Context c, long time, long minResolution, 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long transitionResolution, int flags) { 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Resources r = Resources.getSystem(); 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long now = System.currentTimeMillis(); 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long duration = Math.abs(now - time); 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // getRelativeTimeSpanString() doesn't correctly format relative dates 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // above a week or exact dates below a day, so clamp 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // transitionResolution as needed. 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (transitionResolution > WEEK_IN_MILLIS) { 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project transitionResolution = WEEK_IN_MILLIS; 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (transitionResolution < DAY_IN_MILLIS) { 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project transitionResolution = DAY_IN_MILLIS; 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CharSequence timeClause = formatDateRange(c, time, time, FORMAT_SHOW_TIME); 51999a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String result; 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (duration < transitionResolution) { 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CharSequence relativeClause = getRelativeTimeSpanString(time, now, minResolution, flags); 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = r.getString(com.android.internal.R.string.relative_time, relativeClause, timeClause); 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CharSequence dateClause = getRelativeTimeSpanString(c, time, false); 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = r.getString(com.android.internal.R.string.date_time, dateClause, timeClause); 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return result; 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a string describing a day relative to the current day. For example if the day is 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * today this function returns "Today", if the day was a week ago it returns "7 days ago", and 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the day is in 2 weeks it returns "in 14 days". 53699a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r the resources to get the strings from 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param day the relative day to describe in UTC milliseconds 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param today the current time in UTC milliseconds 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a formatting string 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String getRelativeDayString(Resources r, long day, long today) { 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Time startTime = new Time(); 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTime.set(day); 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Time currentTime = new Time(); 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project currentTime.set(today); 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startDay = Time.getJulianDay(day, startTime.gmtoff); 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int currentDay = Time.getJulianDay(today, currentTime.gmtoff); 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int days = Math.abs(currentDay - startDay); 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean past = (today > day); 55399a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 554c3ff72f5bd5896ad2584e0cc0582cbd2ad8191f2Elliott Hughes // TODO: some locales name other days too, such as de_DE's "Vorgestern" (today - 2). 555c3ff72f5bd5896ad2584e0cc0582cbd2ad8191f2Elliott Hughes Locale locale = r.getConfiguration().locale; 556c3ff72f5bd5896ad2584e0cc0582cbd2ad8191f2Elliott Hughes if (locale == null) { 557c3ff72f5bd5896ad2584e0cc0582cbd2ad8191f2Elliott Hughes locale = Locale.getDefault(); 558c3ff72f5bd5896ad2584e0cc0582cbd2ad8191f2Elliott Hughes } 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (days == 1) { 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (past) { 561c3ff72f5bd5896ad2584e0cc0582cbd2ad8191f2Elliott Hughes return LocaleData.get(locale).yesterday; 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 563c3ff72f5bd5896ad2584e0cc0582cbd2ad8191f2Elliott Hughes return LocaleData.get(locale).tomorrow; 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (days == 0) { 566c3ff72f5bd5896ad2584e0cc0582cbd2ad8191f2Elliott Hughes return LocaleData.get(locale).today; 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resId; 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (past) { 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.num_days_ago; 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resId = com.android.internal.R.plurals.in_num_days; 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 57599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String format = r.getQuantityString(resId, days); 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return String.format(format, days); 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void initFormatStrings() { 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (sLock) { 58225d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK initFormatStringsLocked(); 58325d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK } 58425d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK } 58525d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK 58625d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK private static void initFormatStringsLocked() { 58725d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK Resources r = Resources.getSystem(); 58825d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK Configuration cfg = r.getConfiguration(); 58925d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK if (sLastConfig == null || !sLastConfig.equals(cfg)) { 59025d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK sLastConfig = cfg; 59125d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK sStatusTimeFormat = java.text.DateFormat.getTimeInstance(java.text.DateFormat.SHORT); 59225d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK sElapsedFormatMMSS = r.getString(com.android.internal.R.string.elapsed_time_short_format_mm_ss); 59325d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK sElapsedFormatHMMSS = r.getString(com.android.internal.R.string.elapsed_time_short_format_h_mm_ss); 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Format a time so it appears like it would in the status bar clock. 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link #DateFormat.getTimeFormat(Context)} instead. 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final CharSequence timeString(long millis) { 60325d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK synchronized (sLock) { 60425d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK initFormatStringsLocked(); 60525d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK return sStatusTimeFormat.format(millis); 60625d8b05fb77e8ee755aacd27c1c2d3b237537b7aJozef BABJAK } 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 61053f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey * Return given duration in a human-friendly format. For example, "4 61153f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey * minutes" or "1 second". Returns only largest meaningful unit of time, 61253f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey * from seconds up to hours. 61353f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey * 61453f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey * @hide 61553f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey */ 61653f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey public static CharSequence formatDuration(long millis) { 61753f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey final Resources res = Resources.getSystem(); 61853f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey if (millis >= HOUR_IN_MILLIS) { 61953f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey final int hours = (int) ((millis + 1800000) / HOUR_IN_MILLIS); 62053f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey return res.getQuantityString( 62153f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey com.android.internal.R.plurals.duration_hours, hours, hours); 62253f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey } else if (millis >= MINUTE_IN_MILLIS) { 62353f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey final int minutes = (int) ((millis + 30000) / MINUTE_IN_MILLIS); 62453f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey return res.getQuantityString( 62553f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey com.android.internal.R.plurals.duration_minutes, minutes, minutes); 62653f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey } else { 62753f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey final int seconds = (int) ((millis + 500) / SECOND_IN_MILLIS); 62853f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey return res.getQuantityString( 62953f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey com.android.internal.R.plurals.duration_seconds, seconds, seconds); 63053f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey } 63153f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey } 63253f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey 63353f6e8a9b95a1fe5229295ade4989339d577de08Jeff Sharkey /** 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Formats an elapsed time in the form "MM:SS" or "H:MM:SS" 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for display on the call-in-progress screen. 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param elapsedSeconds the elapsed time in seconds. 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String formatElapsedTime(long elapsedSeconds) { 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return formatElapsedTime(null, elapsedSeconds); 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 64199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Formats an elapsed time in the form "MM:SS" or "H:MM:SS" 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for display on the call-in-progress screen. 64599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param recycle {@link StringBuilder} to recycle, if possible 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param elapsedSeconds the elapsed time in seconds. 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String formatElapsedTime(StringBuilder recycle, long elapsedSeconds) { 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project initFormatStrings(); 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long hours = 0; 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long minutes = 0; 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long seconds = 0; 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (elapsedSeconds >= 3600) { 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hours = elapsedSeconds / 3600; 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project elapsedSeconds -= hours * 3600; 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (elapsedSeconds >= 60) { 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project minutes = elapsedSeconds / 60; 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project elapsedSeconds -= minutes * 60; 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project seconds = elapsedSeconds; 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String result; 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (hours > 0) { 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return formatElapsedTime(recycle, sElapsedFormatHMMSS, hours, minutes, seconds); 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return formatElapsedTime(recycle, sElapsedFormatMMSS, minutes, seconds); 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 674315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader private static void append(StringBuilder sb, long value, boolean pad, char zeroDigit) { 675315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader if (value < 10) { 676315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader if (pad) { 677315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader sb.append(zeroDigit); 678315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader } 679315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader } else { 680315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader sb.append((char) (zeroDigit + (value / 10))); 681315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader } 682315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader sb.append((char) (zeroDigit + (value % 10))); 683315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader } 684315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 686315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader * Fast formatting of h:mm:ss. 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String formatElapsedTime(StringBuilder recycle, String format, long hours, 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long minutes, long seconds) { 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (FAST_FORMAT_HMMSS.equals(format)) { 691315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader char zeroDigit = LocaleData.get(Locale.getDefault()).zeroDigit; 692315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = recycle; 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sb == null) { 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb = new StringBuilder(8); 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setLength(0); 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 699315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader append(sb, hours, false, zeroDigit); 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(TIME_SEPARATOR); 701315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader append(sb, minutes, true, zeroDigit); 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(TIME_SEPARATOR); 703315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader append(sb, seconds, true, zeroDigit); 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sb.toString(); 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return String.format(format, hours, minutes, seconds); 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 711315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader * Fast formatting of mm:ss. 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String formatElapsedTime(StringBuilder recycle, String format, long minutes, 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long seconds) { 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (FAST_FORMAT_MMSS.equals(format)) { 716315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader char zeroDigit = LocaleData.get(Locale.getDefault()).zeroDigit; 717315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = recycle; 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sb == null) { 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb = new StringBuilder(8); 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setLength(0); 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 724315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader append(sb, minutes, false, zeroDigit); 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(TIME_SEPARATOR); 726315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader append(sb, seconds, true, zeroDigit); 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sb.toString(); 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return String.format(format, minutes, seconds); 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Format a date / time such that if the then is on the same day as now, it shows 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * just the time and if it's a different day, it shows just the date. 73699a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The parameters dateFormat and timeFormat should each be one of 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.text.DateFormat#DEFAULT}, 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.text.DateFormat#FULL}, 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.text.DateFormat#LONG}, 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.text.DateFormat#MEDIUM} 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.text.DateFormat#SHORT} 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param then the date to format 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param now the base time 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dateStyle how to format the date portion. 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param timeStyle how to format the time portion. 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final CharSequence formatSameDayTime(long then, long now, 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int dateStyle, int timeStyle) { 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Calendar thenCal = new GregorianCalendar(); 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project thenCal.setTimeInMillis(then); 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Date thenDate = thenCal.getTime(); 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Calendar nowCal = new GregorianCalendar(); 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nowCal.setTimeInMillis(now); 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project java.text.DateFormat f; 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (thenCal.get(Calendar.YEAR) == nowCal.get(Calendar.YEAR) 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && thenCal.get(Calendar.MONTH) == nowCal.get(Calendar.MONTH) 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && thenCal.get(Calendar.DAY_OF_MONTH) == nowCal.get(Calendar.DAY_OF_MONTH)) { 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project f = java.text.DateFormat.getTimeInstance(timeStyle); 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project f = java.text.DateFormat.getDateInstance(dateStyle); 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return f.format(thenDate); 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Calendar newCalendar(boolean zulu) 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (zulu) 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Calendar.getInstance(TimeZone.getTimeZone("GMT")); 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Calendar.getInstance(); 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the supplied when is today else false 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean isToday(long when) { 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Time time = new Time(); 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project time.set(when); 78899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int thenYear = time.year; 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int thenMonth = time.month; 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int thenMonthDay = time.monthDay; 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project time.set(System.currentTimeMillis()); 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (thenYear == time.year) 79599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson && (thenMonth == time.month) 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (thenMonthDay == time.monthDay); 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if this date string is local time 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean isUTC(String s) 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (s.length() == 16 && s.charAt(15) == 'Z') { 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (s.length() == 9 && s.charAt(8) == 'Z') { 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // XXX not sure if this case possible/valid 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a string containing the date and time in RFC2445 format. 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ensures that the time is written in UTC. The Calendar class doesn't 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * really help out with this, so this is slower than it ought to be. 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cal the date and time to write 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String writeDateTime(Calendar cal) 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TimeZone tz = TimeZone.getTimeZone("GMT"); 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GregorianCalendar c = new GregorianCalendar(tz); 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project c.setTimeInMillis(cal.getTimeInMillis()); 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return writeDateTime(c, true); 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a string containing the date and time in RFC2445 format. 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cal the date and time to write 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param zulu If the calendar is in UTC, pass true, and a Z will 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be written at the end as per RFC2445. Otherwise, the time is 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * considered in localtime. 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String writeDateTime(Calendar cal, boolean zulu) 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = new StringBuilder(); 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.ensureCapacity(16); 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (zulu) { 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setLength(16); 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(15, 'Z'); 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setLength(15); 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return writeDateTime(cal, sb); 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a string containing the date and time in RFC2445 format. 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cal the date and time to write 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sb a StringBuilder to use. It is assumed that setLength 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has already been called on sb to the appropriate length 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which is sb.setLength(zulu ? 16 : 15) 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String writeDateTime(Calendar cal, StringBuilder sb) 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int n; 86999a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.YEAR); 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(3, (char)('0'+n%10)); 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(2, (char)('0'+n%10)); 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(1, (char)('0'+n%10)); 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(0, (char)('0'+n%10)); 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.MONTH) + 1; 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(5, (char)('0'+n%10)); 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(4, (char)('0'+n%10)); 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.DAY_OF_MONTH); 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(7, (char)('0'+n%10)); 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(6, (char)('0'+n%10)); 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(8, 'T'); 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.HOUR_OF_DAY); 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(10, (char)('0'+n%10)); 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(9, (char)('0'+n%10)); 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.MINUTE); 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(12, (char)('0'+n%10)); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(11, (char)('0'+n%10)); 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.SECOND); 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(14, (char)('0'+n%10)); 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(13, (char)('0'+n%10)); 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sb.toString(); 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void assign(Calendar lval, Calendar rval) 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // there should be a faster way. 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project lval.clear(); 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project lval.setTimeInMillis(rval.getTimeInMillis()); 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Formats a date or a time range according to the local conventions. 922becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * <p> 923becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * Note that this is a convenience method. Using it involves creating an 924becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * internal {@link java.util.Formatter} instance on-the-fly, which is 925becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * somewhat costly in terms of memory and time. This is probably acceptable 926becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * if you use the method only rarely, but if you rely on it for formatting a 927becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * large number of dates, consider creating and reusing your own 928becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * {@link java.util.Formatter} instance and use the version of 929becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * {@link #formatDateRange(Context, long, long, int) formatDateRange} 930becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * that takes a {@link java.util.Formatter}. 931577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * 932becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @param context the context is required only if the time is shown 933becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @param startMillis the start time in UTC milliseconds 934becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @param endMillis the end time in UTC milliseconds 935becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @param flags a bit mask of options See 936577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * {@link #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange} 937becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @return a string containing the formatted date/time range. 938becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan */ 939becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan public static String formatDateRange(Context context, long startMillis, 940becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan long endMillis, int flags) { 941becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan Formatter f = new Formatter(new StringBuilder(50), Locale.getDefault()); 942becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatDateRange(context, f, startMillis, endMillis, flags).toString(); 943becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan } 944becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan 945becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan /** 946becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * Formats a date or a time range according to the local conventions. 947577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * <p> 948577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * Note that this is a convenience method for formatting the date or 949577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * time range in the local time zone. If you want to specify the time 950577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * zone please use 951577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * {@link #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange}. 952577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * 953577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param context the context is required only if the time is shown 954577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param formatter the Formatter used for formatting the date range. 955577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * Note: be sure to call setLength(0) on StringBuilder passed to 956577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * the Formatter constructor unless you want the results to accumulate. 957577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param startMillis the start time in UTC milliseconds 958577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param endMillis the end time in UTC milliseconds 959577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param flags a bit mask of options See 960577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * {@link #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange} 961577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @return a string containing the formatted date/time range. 962577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik */ 963577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik public static Formatter formatDateRange(Context context, Formatter formatter, long startMillis, 964577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik long endMillis, int flags) { 965577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik return formatDateRange(context, formatter, startMillis, endMillis, flags, null); 966577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } 967577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik 968577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik /** 969577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * Formats a date or a time range according to the local conventions. 97099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example output strings (date formats in these examples are shown using 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the US date format convention but that may change depending on the 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * local settings): 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>10:15am</li> 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3:00pm - 4:00pm</li> 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3pm - 4pm</li> 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3PM - 4PM</li> 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>08:00 - 17:00</li> 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 9</li> 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Tue, Oct 9</li> 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>October 9, 2007</li> 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 9 - 10</li> 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 9 - 10, 2007</li> 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 28 - Nov 3, 2007</li> 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Dec 31, 2007 - Jan 1, 2008</li> 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 9, 8:00am - Oct 10, 5:00pm</li> 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>12/31/2007 - 01/01/2008</li> 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 99199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The flags argument is a bitmask of options from the following list: 99499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_SHOW_TIME</li> 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_SHOW_WEEKDAY</li> 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_SHOW_YEAR</li> 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_NO_YEAR</li> 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_SHOW_DATE</li> 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_NO_MONTH_DAY</li> 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_12HOUR</li> 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_24HOUR</li> 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_CAP_AMPM</li> 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_NO_NOON</li> 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_CAP_NOON</li> 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_NO_MIDNIGHT</li> 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_CAP_MIDNIGHT</li> 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_UTC</li> 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_ABBREV_TIME</li> 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_ABBREV_WEEKDAY</li> 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_ABBREV_MONTH</li> 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_ABBREV_ALL</li> 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_NUMERIC_DATE</li> 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 101699a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_SHOW_TIME is set, the time is shown as part of the date range. 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the start and end time are the same, then just the start time is 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown. 102199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_SHOW_WEEKDAY is set, then the weekday is shown. 102499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_SHOW_YEAR is set, then the year is always shown. 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_NO_YEAR is set, then the year is not shown. 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If neither FORMAT_SHOW_YEAR nor FORMAT_NO_YEAR are set, then the year 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is shown only if it is different from the current year, or if the start 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and end dates fall on different years. If both are set, 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * FORMAT_SHOW_YEAR takes precedence. 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally the date is shown unless the start and end day are the same. 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_SHOW_DATE is set, then the date is always shown, even for 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same day ranges. 103799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_NO_MONTH_DAY is set, then if the date is shown, just the 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * month name will be shown, not the day of the month. For example, 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "January, 2008" instead of "January 6 - 12, 2008". 104299a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_CAP_AMPM is set and 12-hour time is used, then the "AM" 104584c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * and "PM" are capitalized. You should not use this flag 104684c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * because in some locales these terms cannot be capitalized, and in 104784c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * many others it doesn't make sense to do so even though it is possible. 104899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_NO_NOON is set and 12-hour time is used, then "12pm" is 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown instead of "noon". 105299a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_CAP_NOON is set and 12-hour time is used, then "Noon" is 105584c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * shown instead of "noon". You should probably not use this flag 105684c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * because in many locales it will not make sense to capitalize 105784c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * the term. 105899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_NO_MIDNIGHT is set and 12-hour time is used, then "12am" is 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown instead of "midnight". 106299a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 106484c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * If FORMAT_CAP_MIDNIGHT is set and 12-hour time is used, then "Midnight" 106584c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * is shown instead of "midnight". You should probably not use this 106684c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * flag because in many locales it will not make sense to capitalize 106784c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * the term. 106899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_12HOUR is set and the time is shown, then the time is 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown in the 12-hour time format. You should not normally set this. 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Instead, let the time format be chosen automatically according to the 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * system settings. If both FORMAT_12HOUR and FORMAT_24HOUR are set, then 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * FORMAT_24HOUR takes precedence. 107599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_24HOUR is set and the time is shown, then the time is 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown in the 24-hour time format. You should not normally set this. 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Instead, let the time format be chosen automatically according to the 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * system settings. If both FORMAT_12HOUR and FORMAT_24HOUR are set, then 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * FORMAT_24HOUR takes precedence. 108299a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 1084577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * If FORMAT_UTC is set, then the UTC time zone is used for the start 1085577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * and end milliseconds unless a time zone is specified. If a time zone 1086577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * is specified it will be used regardless of the FORMAT_UTC flag. 108799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_ABBREV_TIME is set and 12-hour time format is used, then the 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * start and end times (if shown) are abbreviated by not showing the minutes 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if they are zero. For example, instead of "3:00pm" the time would be 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * abbreviated to "3pm". 109399a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_ABBREV_WEEKDAY is set, then the weekday (if shown) is 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * abbreviated to a 3-letter string. 109799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_ABBREV_MONTH is set, then the month (if shown) is abbreviated 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to a 3-letter string. 110199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_ABBREV_ALL is set, then the weekday and the month (if shown) 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are abbreviated to 3-letter strings. 110599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_NUMERIC_DATE is set, then the date is shown in numeric format 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instead of using the name of the month. For example, "12/31/2008" 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instead of "December 31, 2008". 111099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 111199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * <p> 111299a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * If the end date ends at 12:00am at the beginning of a day, it is 111399a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * formatted as the end of the previous day in two scenarios: 111499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * <ul> 111599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * <li>For single day events. This results in "8pm - midnight" instead of 111699a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * "Nov 10, 8pm - Nov 11, 12am".</li> 111799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * <li>When the time is not displayed. This results in "Nov 10 - 11" for 111899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * an event with a start date of Nov 10 and an end date of Nov 12 at 111999a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 00:00.</li> 112099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * </ul> 112199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context the context is required only if the time is shown 1123becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @param formatter the Formatter used for formatting the date range. 1124becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * Note: be sure to call setLength(0) on StringBuilder passed to 1125becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * the Formatter constructor unless you want the results to accumulate. 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startMillis the start time in UTC milliseconds 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param endMillis the end time in UTC milliseconds 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags a bit mask of options 1129577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param timeZone the time zone to compute the string in. Use null for local 1130577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * or if the FORMAT_UTC flag is being used. 113199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 1132becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @return the formatter with the formatted date/time range appended to the string buffer. 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1134becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan public static Formatter formatDateRange(Context context, Formatter formatter, long startMillis, 1135577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik long endMillis, int flags, String timeZone) { 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Resources res = Resources.getSystem(); 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean showTime = (flags & FORMAT_SHOW_TIME) != 0; 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean showWeekDay = (flags & FORMAT_SHOW_WEEKDAY) != 0; 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean showYear = (flags & FORMAT_SHOW_YEAR) != 0; 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean noYear = (flags & FORMAT_NO_YEAR) != 0; 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean useUTC = (flags & FORMAT_UTC) != 0; 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean abbrevWeekDay = (flags & (FORMAT_ABBREV_WEEKDAY | FORMAT_ABBREV_ALL)) != 0; 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean abbrevMonth = (flags & (FORMAT_ABBREV_MONTH | FORMAT_ABBREV_ALL)) != 0; 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean noMonthDay = (flags & FORMAT_NO_MONTH_DAY) != 0; 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean numericDate = (flags & FORMAT_NUMERIC_DATE) != 0; 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // If we're getting called with a single instant in time (from 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // e.g. formatDateTime(), below), then we can skip a lot of 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // computation below that'd otherwise be thrown out. 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isInstant = (startMillis == endMillis); 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1152577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik Time startDate; 1153577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik if (timeZone != null) { 1154577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik startDate = new Time(timeZone); 1155577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } else if (useUTC) { 1156577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik startDate = new Time(Time.TIMEZONE_UTC); 1157577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } else { 1158577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik startDate = new Time(); 1159577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startDate.set(startMillis); 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Time endDate; 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int dayDistance; 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (isInstant) { 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endDate = startDate; 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dayDistance = 0; 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1168577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik if (timeZone != null) { 1169577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik endDate = new Time(timeZone); 1170577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } else if (useUTC) { 1171577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik endDate = new Time(Time.TIMEZONE_UTC); 1172577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } else { 1173577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik endDate = new Time(); 1174577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endDate.set(endMillis); 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startJulianDay = Time.getJulianDay(startMillis, startDate.gmtoff); 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int endJulianDay = Time.getJulianDay(endMillis, endDate.gmtoff); 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dayDistance = endJulianDay - startJulianDay; 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isInstant 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (endDate.hour | endDate.minute | endDate.second) == 0 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (!showTime || dayDistance <= 1)) { 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endDate.monthDay -= 1; 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endDate.normalize(true /* ignore isDst */); 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startDay = startDate.monthDay; 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startMonthNum = startDate.month; 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startYear = startDate.year; 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int endDay = endDate.monthDay; 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int endMonthNum = endDate.month; 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int endYear = endDate.year; 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startWeekDayString = ""; 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endWeekDayString = ""; 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showWeekDay) { 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String weekDayFormat = ""; 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevWeekDay) { 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project weekDayFormat = ABBREV_WEEKDAY_FORMAT; 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project weekDayFormat = WEEKDAY_FORMAT; 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startWeekDayString = startDate.format(weekDayFormat); 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endWeekDayString = isInstant ? startWeekDayString : endDate.format(weekDayFormat); 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startTimeString = ""; 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endTimeString = ""; 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startTimeFormat = ""; 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endTimeFormat = ""; 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean force24Hour = (flags & FORMAT_24HOUR) != 0; 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean force12Hour = (flags & FORMAT_12HOUR) != 0; 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean use24Hour; 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (force24Hour) { 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project use24Hour = true; 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (force12Hour) { 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project use24Hour = false; 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project use24Hour = DateFormat.is24HourFormat(context); 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (use24Hour) { 122584c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer startTimeFormat = endTimeFormat = 122684c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer res.getString(com.android.internal.R.string.hour_minute_24); 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean abbrevTime = (flags & (FORMAT_ABBREV_TIME | FORMAT_ABBREV_ALL)) != 0; 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean capAMPM = (flags & FORMAT_CAP_AMPM) != 0; 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean noNoon = (flags & FORMAT_NO_NOON) != 0; 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean capNoon = (flags & FORMAT_CAP_NOON) != 0; 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean noMidnight = (flags & FORMAT_NO_MIDNIGHT) != 0; 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean capMidnight = (flags & FORMAT_CAP_MIDNIGHT) != 0; 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean startOnTheHour = startDate.minute == 0 && startDate.second == 0; 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean endOnTheHour = endDate.minute == 0 && endDate.second == 0; 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevTime && startOnTheHour) { 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capAMPM) { 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.hour_cap_ampm); 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.hour_ampm); 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capAMPM) { 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.hour_minute_cap_ampm); 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.hour_minute_ampm); 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Don't waste time on setting endTimeFormat when 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we're dealing with an instant, where we'll never 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // need the end point. (It's the same as the start 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // point) 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isInstant) { 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevTime && endOnTheHour) { 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capAMPM) { 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.hour_cap_ampm); 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.hour_ampm); 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capAMPM) { 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.hour_minute_cap_ampm); 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.hour_minute_ampm); 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (endDate.hour == 12 && endOnTheHour && !noNoon) { 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capNoon) { 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.Noon); 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.noon); 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (endDate.hour == 0 && endOnTheHour && !noMidnight) { 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capMidnight) { 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.Midnight); 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.midnight); 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (startDate.hour == 12 && startOnTheHour && !noNoon) { 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capNoon) { 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.Noon); 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.noon); 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Don't show the start time starting at midnight. Show 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // 12am instead. 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeString = startDate.format(startTimeFormat); 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeString = isInstant ? startTimeString : endDate.format(endTimeFormat); 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Show the year if the user specified FORMAT_SHOW_YEAR or if 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the starting and end years are different from each other 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // or from the current year. But don't show the year if the 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // user specified FORMAT_NO_YEAR. 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showYear) { 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // No code... just a comment for clarity. Keep showYear 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // on, as they enabled it with FORMAT_SHOW_YEAR. This 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // takes precedence over them setting FORMAT_NO_YEAR. 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (noYear) { 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // They explicitly didn't want a year. 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project showYear = false; 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (startYear != endYear) { 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project showYear = true; 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Show the year if it's not equal to the current year. 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Time currentTime = new Time(); 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project currentTime.setToNow(); 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project showYear = startYear != currentTime.year; 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String defaultDateFormat, fullFormat, dateRange; 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (numericDate) { 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.numeric_date); 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (showYear) { 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevMonth) { 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (noMonthDay) { 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.abbrev_month_year); 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.abbrev_month_day_year); 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (noMonthDay) { 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.month_year); 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.month_day_year); 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevMonth) { 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (noMonthDay) { 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.abbrev_month); 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.abbrev_month_day); 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (noMonthDay) { 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.month); 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.month_day); 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showWeekDay) { 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.wday1_date1_time1_wday2_date2_time2); 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.wday1_date1_wday2_date2); 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.date1_time1_date2_time2); 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.date1_date2); 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1367b193e35ed131769e6c98b2752635065489198aebOwen Lin if (noMonthDay && startMonthNum == endMonthNum && startYear == endYear) { 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "January, 2008" 1369becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format("%s", startDate.format(defaultDateFormat)); 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (startYear != endYear || noMonthDay) { 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Different year or we are not showing the month day number. 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "December 31, 2007 - January 1, 2008" 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Or: "January - February, 2008" 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startDateString = startDate.format(defaultDateFormat); 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endDateString = endDate.format(defaultDateFormat); 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The values that are used in a fullFormat string are specified 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // by position. 1381becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format(fullFormat, 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startWeekDayString, startDateString, startTimeString, 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endWeekDayString, endDateString, endTimeString); 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Get the month, day, and year strings for the start and end dates 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String monthFormat; 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (numericDate) { 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project monthFormat = NUMERIC_MONTH_FORMAT; 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (abbrevMonth) { 13915669ce59aad19f17e1e89913e7483fb93b8aa0cfEric Fischer monthFormat = 13925669ce59aad19f17e1e89913e7483fb93b8aa0cfEric Fischer res.getString(com.android.internal.R.string.short_format_month); 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project monthFormat = MONTH_FORMAT; 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startMonthString = startDate.format(monthFormat); 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startMonthDayString = startDate.format(MONTH_DAY_FORMAT); 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startYearString = startDate.format(YEAR_FORMAT); 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endMonthString = isInstant ? null : endDate.format(monthFormat); 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endMonthDayString = isInstant ? null : endDate.format(MONTH_DAY_FORMAT); 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endYearString = isInstant ? null : endDate.format(YEAR_FORMAT); 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14049ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes String startStandaloneMonthString = startMonthString; 14059ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes String endStandaloneMonthString = endMonthString; 14069ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes // We need standalone months for these strings in Persian (fa): http://b/6811327 14079ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes if (!numericDate && !abbrevMonth && Locale.getDefault().getLanguage().equals("fa")) { 14089ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes startStandaloneMonthString = startDate.format("%-B"); 14099ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes endStandaloneMonthString = endDate.format("%-B"); 14109ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes } 14119ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (startMonthNum != endMonthNum) { 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Same year, different month. 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "October 28 - November 3" 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // or: "Wed, Oct 31 - Sat, Nov 3, 2007" 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // or: "Oct 31, 8am - Sat, Nov 3, 2007, 5pm" 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index = 0; 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showWeekDay) index = 1; 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showYear) index += 2; 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) index += 4; 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (numericDate) index += 8; 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resId = sameYearTable[index]; 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(resId); 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The values that are used in a fullFormat string are specified 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // by position. 1428becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format(fullFormat, 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startWeekDayString, startMonthString, startMonthDayString, 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startYearString, startTimeString, 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endWeekDayString, endMonthString, endMonthDayString, 14329ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes endYearString, endTimeString, 14339ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes startStandaloneMonthString, endStandaloneMonthString); 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (startDay != endDay) { 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Same month, different day. 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index = 0; 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showWeekDay) index = 1; 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showYear) index += 2; 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) index += 4; 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (numericDate) index += 8; 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resId = sameMonthTable[index]; 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(resId); 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The values that are used in a fullFormat string are specified 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // by position. 1448becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format(fullFormat, 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startWeekDayString, startMonthString, startMonthDayString, 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startYearString, startTimeString, 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endWeekDayString, endMonthString, endMonthDayString, 14529ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes endYearString, endTimeString, 14539ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes startStandaloneMonthString, endStandaloneMonthString); 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Same start and end day 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean showDate = (flags & FORMAT_SHOW_DATE) != 0; 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // If nothing was specified, then show the date. 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!showTime && !showDate && !showWeekDay) showDate = true; 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Compute the time string (example: "10:00 - 11:00 am") 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String timeString = ""; 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // If the start and end time are the same, then just show the 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // start time. 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (isInstant) { 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Same start and end time. 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "10:15 AM" 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project timeString = startTimeString; 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "10:00 - 11:00 am" 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String timeFormat = res.getString(com.android.internal.R.string.time1_time2); 1474becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan // Don't use the user supplied Formatter because the result will pollute the buffer. 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project timeString = String.format(timeFormat, startTimeString, endTimeString); 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Figure out which full format to use. 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = ""; 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String dateString = ""; 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showDate) { 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dateString = startDate.format(defaultDateFormat); 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showWeekDay) { 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "10:00 - 11:00 am, Tue, Oct 9" 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.time_wday_date); 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "Tue, Oct 9" 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.wday_date); 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "10:00 - 11:00 am, Oct 9" 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.time_date); 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "Oct 9" 1498becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format("%s", dateString); 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (showWeekDay) { 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "10:00 - 11:00 am, Tue" 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.time_wday); 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "Tue" 1507becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format("%s", startWeekDayString); 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (showTime) { 1510becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format("%s", timeString); 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The values that are used in a fullFormat string are specified 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // by position. 1515becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format(fullFormat, timeString, startWeekDayString, dateString); 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Formats a date or a time according to the local conventions. There are 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lots of options that allow the caller to control, for example, if the 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * time is shown, if the day of the week is shown, if the month name is 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * abbreviated, if noon is shown instead of 12pm, and so on. For the 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * complete list of options, see the documentation for 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #formatDateRange}. 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example output strings (date formats in these examples are shown using 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the US date format convention but that may change depending on the 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * local settings): 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>10:15am</li> 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3:00pm</li> 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3pm</li> 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3PM</li> 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>08:00</li> 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>17:00</li> 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>noon</li> 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Noon</li> 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>midnight</li> 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Midnight</li> 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 31</li> 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 31, 2007</li> 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>October 31, 2007</li> 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>10am, Oct 31</li> 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>17:00, Oct 31</li> 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wed</li> 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wednesday</li> 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>10am, Wed, Oct 31</li> 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wed, Oct 31</li> 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wednesday, Oct 31</li> 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wed, Oct 31, 2007</li> 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wed, October 31</li> 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>10/31/2007</li> 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 155499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context the context is required only if the time is shown 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param millis a point in time in UTC milliseconds 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags a bit mask of formatting options 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a string containing the formatted date/time. 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String formatDateTime(Context context, long millis, int flags) { 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return formatDateRange(context, millis, millis, flags); 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a relative time string to display the time expressed by millis. Times 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are counted starting at midnight, which means that assuming that the current 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * time is March 31st, 0:30: 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 156999a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * <li>"millis=0:10 today" will be displayed as "0:10"</li> 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>"millis=11:30pm the day before" will be displayed as "Mar 30"</li> 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the given millis is in a different year, then the full date is 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned in numeric format (e.g., "10/12/2008"). 157499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 157599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * @param withPreposition If true, the string returned will include the correct 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * preposition ("at 9:20am", "on 10/12/2008" or "on May 29"). 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static CharSequence getRelativeTimeSpanString(Context c, long millis, 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean withPreposition) { 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15816a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques String result; 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long now = System.currentTimeMillis(); 1583ca3363775e03e0f90bdf111d3e5c54b3ab16df57Steve Pomeroy long span = Math.abs(now - millis); 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15856a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques synchronized (DateUtils.class) { 15866a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques if (sNowTime == null) { 15876a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sNowTime = new Time(); 15886a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15906a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques if (sThenTime == null) { 15916a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sThenTime = new Time(); 15926a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15946a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sNowTime.set(now); 15956a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sThenTime.set(millis); 15966a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques 15976a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques int prepositionId; 15986a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques if (span < DAY_IN_MILLIS && sNowTime.weekDay == sThenTime.weekDay) { 15996a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques // Same day 16006a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques int flags = FORMAT_SHOW_TIME; 16016a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques result = formatDateRange(c, millis, millis, flags); 16026a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques prepositionId = R.string.preposition_for_time; 16036a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } else if (sNowTime.year != sThenTime.year) { 16046a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques // Different years 16056a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques int flags = FORMAT_SHOW_DATE | FORMAT_SHOW_YEAR | FORMAT_NUMERIC_DATE; 16066a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques result = formatDateRange(c, millis, millis, flags); 16076a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques 16086a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques // This is a date (like "10/31/2008" so use the date preposition) 16096a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques prepositionId = R.string.preposition_for_date; 16106a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } else { 16116a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques // Default 16126a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques int flags = FORMAT_SHOW_DATE | FORMAT_ABBREV_MONTH; 16136a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques result = formatDateRange(c, millis, millis, flags); 16146a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques prepositionId = R.string.preposition_for_date; 16156a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } 16166a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques if (withPreposition) { 16176a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques Resources res = c.getResources(); 16186a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques result = res.getString(prepositionId, result); 16196a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return result; 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 162399a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 162599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * Convenience function to return relative time string without preposition. 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param c context for resources 16279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param millis time in milliseconds 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link CharSequence} containing relative time. 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRelativeTimeSpanString(Context, long, boolean) 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static CharSequence getRelativeTimeSpanString(Context c, long millis) { 16329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getRelativeTimeSpanString(c, millis, false /* no preposition */); 16339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 163499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static Time sNowTime; 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static Time sThenTime; 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1638