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 /** 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Formats an elapsed time in the form "MM:SS" or "H:MM:SS" 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for display on the call-in-progress screen. 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param elapsedSeconds the elapsed time in seconds. 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String formatElapsedTime(long elapsedSeconds) { 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return formatElapsedTime(null, elapsedSeconds); 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 61799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Formats an elapsed time in the form "MM:SS" or "H:MM:SS" 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for display on the call-in-progress screen. 62199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param recycle {@link StringBuilder} to recycle, if possible 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param elapsedSeconds the elapsed time in seconds. 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String formatElapsedTime(StringBuilder recycle, long elapsedSeconds) { 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project initFormatStrings(); 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long hours = 0; 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long minutes = 0; 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long seconds = 0; 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (elapsedSeconds >= 3600) { 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hours = elapsedSeconds / 3600; 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project elapsedSeconds -= hours * 3600; 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (elapsedSeconds >= 60) { 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project minutes = elapsedSeconds / 60; 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project elapsedSeconds -= minutes * 60; 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project seconds = elapsedSeconds; 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String result; 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (hours > 0) { 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return formatElapsedTime(recycle, sElapsedFormatHMMSS, hours, minutes, seconds); 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return formatElapsedTime(recycle, sElapsedFormatMMSS, minutes, seconds); 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 650315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader private static void append(StringBuilder sb, long value, boolean pad, char zeroDigit) { 651315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader if (value < 10) { 652315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader if (pad) { 653315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader sb.append(zeroDigit); 654315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader } 655315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader } else { 656315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader sb.append((char) (zeroDigit + (value / 10))); 657315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader } 658315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader sb.append((char) (zeroDigit + (value % 10))); 659315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader } 660315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 662315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader * Fast formatting of h:mm:ss. 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String formatElapsedTime(StringBuilder recycle, String format, long hours, 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long minutes, long seconds) { 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (FAST_FORMAT_HMMSS.equals(format)) { 667315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader char zeroDigit = LocaleData.get(Locale.getDefault()).zeroDigit; 668315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = recycle; 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sb == null) { 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb = new StringBuilder(8); 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setLength(0); 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 675315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader append(sb, hours, false, zeroDigit); 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(TIME_SEPARATOR); 677315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader append(sb, minutes, true, zeroDigit); 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(TIME_SEPARATOR); 679315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader append(sb, seconds, true, zeroDigit); 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sb.toString(); 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return String.format(format, hours, minutes, seconds); 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 687315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader * Fast formatting of mm:ss. 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String formatElapsedTime(StringBuilder recycle, String format, long minutes, 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long seconds) { 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (FAST_FORMAT_MMSS.equals(format)) { 692315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader char zeroDigit = LocaleData.get(Locale.getDefault()).zeroDigit; 693315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = recycle; 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sb == null) { 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb = new StringBuilder(8); 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setLength(0); 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 700315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader append(sb, minutes, false, zeroDigit); 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(TIME_SEPARATOR); 702315a7c0335fb54beced23b1703c10563ce02ee82Roozbeh Pournader append(sb, seconds, true, zeroDigit); 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sb.toString(); 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return String.format(format, minutes, seconds); 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Format a date / time such that if the then is on the same day as now, it shows 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * just the time and if it's a different day, it shows just the date. 71299a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The parameters dateFormat and timeFormat should each be one of 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.text.DateFormat#DEFAULT}, 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.text.DateFormat#FULL}, 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.text.DateFormat#LONG}, 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.text.DateFormat#MEDIUM} 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.text.DateFormat#SHORT} 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param then the date to format 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param now the base time 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dateStyle how to format the date portion. 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param timeStyle how to format the time portion. 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final CharSequence formatSameDayTime(long then, long now, 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int dateStyle, int timeStyle) { 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Calendar thenCal = new GregorianCalendar(); 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project thenCal.setTimeInMillis(then); 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Date thenDate = thenCal.getTime(); 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Calendar nowCal = new GregorianCalendar(); 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nowCal.setTimeInMillis(now); 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project java.text.DateFormat f; 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (thenCal.get(Calendar.YEAR) == nowCal.get(Calendar.YEAR) 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && thenCal.get(Calendar.MONTH) == nowCal.get(Calendar.MONTH) 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && thenCal.get(Calendar.DAY_OF_MONTH) == nowCal.get(Calendar.DAY_OF_MONTH)) { 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project f = java.text.DateFormat.getTimeInstance(timeStyle); 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project f = java.text.DateFormat.getDateInstance(dateStyle); 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return f.format(thenDate); 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Calendar newCalendar(boolean zulu) 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (zulu) 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Calendar.getInstance(TimeZone.getTimeZone("GMT")); 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Calendar.getInstance(); 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the supplied when is today else false 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean isToday(long when) { 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Time time = new Time(); 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project time.set(when); 76499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int thenYear = time.year; 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int thenMonth = time.month; 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int thenMonthDay = time.monthDay; 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project time.set(System.currentTimeMillis()); 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (thenYear == time.year) 77199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson && (thenMonth == time.month) 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (thenMonthDay == time.monthDay); 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if this date string is local time 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean isUTC(String s) 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (s.length() == 16 && s.charAt(15) == 'Z') { 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (s.length() == 9 && s.charAt(8) == 'Z') { 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // XXX not sure if this case possible/valid 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a string containing the date and time in RFC2445 format. 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ensures that the time is written in UTC. The Calendar class doesn't 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * really help out with this, so this is slower than it ought to be. 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cal the date and time to write 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String writeDateTime(Calendar cal) 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TimeZone tz = TimeZone.getTimeZone("GMT"); 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GregorianCalendar c = new GregorianCalendar(tz); 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project c.setTimeInMillis(cal.getTimeInMillis()); 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return writeDateTime(c, true); 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a string containing the date and time in RFC2445 format. 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cal the date and time to write 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param zulu If the calendar is in UTC, pass true, and a Z will 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be written at the end as per RFC2445. Otherwise, the time is 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * considered in localtime. 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String writeDateTime(Calendar cal, boolean zulu) 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = new StringBuilder(); 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.ensureCapacity(16); 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (zulu) { 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setLength(16); 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(15, 'Z'); 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setLength(15); 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return writeDateTime(cal, sb); 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a string containing the date and time in RFC2445 format. 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cal the date and time to write 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sb a StringBuilder to use. It is assumed that setLength 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has already been called on sb to the appropriate length 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which is sb.setLength(zulu ? 16 : 15) 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String writeDateTime(Calendar cal, StringBuilder sb) 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int n; 84599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.YEAR); 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(3, (char)('0'+n%10)); 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(2, (char)('0'+n%10)); 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(1, (char)('0'+n%10)); 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(0, (char)('0'+n%10)); 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.MONTH) + 1; 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(5, (char)('0'+n%10)); 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(4, (char)('0'+n%10)); 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.DAY_OF_MONTH); 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(7, (char)('0'+n%10)); 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(6, (char)('0'+n%10)); 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(8, 'T'); 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.HOUR_OF_DAY); 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(10, (char)('0'+n%10)); 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(9, (char)('0'+n%10)); 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.MINUTE); 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(12, (char)('0'+n%10)); 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(11, (char)('0'+n%10)); 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n = cal.get(Calendar.SECOND); 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(14, (char)('0'+n%10)); 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project n /= 10; 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.setCharAt(13, (char)('0'+n%10)); 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sb.toString(); 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.text.format.Time} 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void assign(Calendar lval, Calendar rval) 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // there should be a faster way. 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project lval.clear(); 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project lval.setTimeInMillis(rval.getTimeInMillis()); 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Formats a date or a time range according to the local conventions. 898becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * <p> 899becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * Note that this is a convenience method. Using it involves creating an 900becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * internal {@link java.util.Formatter} instance on-the-fly, which is 901becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * somewhat costly in terms of memory and time. This is probably acceptable 902becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * if you use the method only rarely, but if you rely on it for formatting a 903becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * large number of dates, consider creating and reusing your own 904becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * {@link java.util.Formatter} instance and use the version of 905becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * {@link #formatDateRange(Context, long, long, int) formatDateRange} 906becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * that takes a {@link java.util.Formatter}. 907577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * 908becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @param context the context is required only if the time is shown 909becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @param startMillis the start time in UTC milliseconds 910becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @param endMillis the end time in UTC milliseconds 911becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @param flags a bit mask of options See 912577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * {@link #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange} 913becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @return a string containing the formatted date/time range. 914becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan */ 915becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan public static String formatDateRange(Context context, long startMillis, 916becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan long endMillis, int flags) { 917becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan Formatter f = new Formatter(new StringBuilder(50), Locale.getDefault()); 918becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatDateRange(context, f, startMillis, endMillis, flags).toString(); 919becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan } 920becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan 921becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan /** 922becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * Formats a date or a time range according to the local conventions. 923577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * <p> 924577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * Note that this is a convenience method for formatting the date or 925577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * time range in the local time zone. If you want to specify the time 926577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * zone please use 927577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * {@link #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange}. 928577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * 929577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param context the context is required only if the time is shown 930577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param formatter the Formatter used for formatting the date range. 931577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * Note: be sure to call setLength(0) on StringBuilder passed to 932577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * the Formatter constructor unless you want the results to accumulate. 933577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param startMillis the start time in UTC milliseconds 934577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param endMillis the end time in UTC milliseconds 935577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param flags a bit mask of options See 936577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * {@link #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange} 937577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @return a string containing the formatted date/time range. 938577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik */ 939577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik public static Formatter formatDateRange(Context context, Formatter formatter, long startMillis, 940577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik long endMillis, int flags) { 941577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik return formatDateRange(context, formatter, startMillis, endMillis, flags, null); 942577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } 943577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik 944577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik /** 945577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * Formats a date or a time range according to the local conventions. 94699a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example output strings (date formats in these examples are shown using 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the US date format convention but that may change depending on the 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * local settings): 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>10:15am</li> 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3:00pm - 4:00pm</li> 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3pm - 4pm</li> 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3PM - 4PM</li> 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>08:00 - 17:00</li> 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 9</li> 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Tue, Oct 9</li> 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>October 9, 2007</li> 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 9 - 10</li> 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 9 - 10, 2007</li> 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 28 - Nov 3, 2007</li> 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Dec 31, 2007 - Jan 1, 2008</li> 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 9, 8:00am - Oct 10, 5:00pm</li> 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>12/31/2007 - 01/01/2008</li> 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 96799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The flags argument is a bitmask of options from the following list: 97099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_SHOW_TIME</li> 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_SHOW_WEEKDAY</li> 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_SHOW_YEAR</li> 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_NO_YEAR</li> 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_SHOW_DATE</li> 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_NO_MONTH_DAY</li> 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_12HOUR</li> 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_24HOUR</li> 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_CAP_AMPM</li> 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_NO_NOON</li> 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_CAP_NOON</li> 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_NO_MIDNIGHT</li> 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_CAP_MIDNIGHT</li> 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_UTC</li> 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_ABBREV_TIME</li> 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_ABBREV_WEEKDAY</li> 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_ABBREV_MONTH</li> 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_ABBREV_ALL</li> 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>FORMAT_NUMERIC_DATE</li> 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 99299a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_SHOW_TIME is set, the time is shown as part of the date range. 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the start and end time are the same, then just the start time is 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown. 99799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_SHOW_WEEKDAY is set, then the weekday is shown. 100099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_SHOW_YEAR is set, then the year is always shown. 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_NO_YEAR is set, then the year is not shown. 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If neither FORMAT_SHOW_YEAR nor FORMAT_NO_YEAR are set, then the year 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is shown only if it is different from the current year, or if the start 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and end dates fall on different years. If both are set, 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * FORMAT_SHOW_YEAR takes precedence. 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally the date is shown unless the start and end day are the same. 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_SHOW_DATE is set, then the date is always shown, even for 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same day ranges. 101399a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_NO_MONTH_DAY is set, then if the date is shown, just the 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * month name will be shown, not the day of the month. For example, 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "January, 2008" instead of "January 6 - 12, 2008". 101899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_CAP_AMPM is set and 12-hour time is used, then the "AM" 102184c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * and "PM" are capitalized. You should not use this flag 102284c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * because in some locales these terms cannot be capitalized, and in 102384c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * many others it doesn't make sense to do so even though it is possible. 102499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_NO_NOON is set and 12-hour time is used, then "12pm" is 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown instead of "noon". 102899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_CAP_NOON is set and 12-hour time is used, then "Noon" is 103184c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * shown instead of "noon". You should probably not use this flag 103284c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * because in many locales it will not make sense to capitalize 103384c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * the term. 103499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_NO_MIDNIGHT is set and 12-hour time is used, then "12am" is 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown instead of "midnight". 103899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 104084c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * If FORMAT_CAP_MIDNIGHT is set and 12-hour time is used, then "Midnight" 104184c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * is shown instead of "midnight". You should probably not use this 104284c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * flag because in many locales it will not make sense to capitalize 104384c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer * the term. 104499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_12HOUR is set and the time is shown, then the time is 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown in the 12-hour time format. You should not normally set this. 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Instead, let the time format be chosen automatically according to the 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * system settings. If both FORMAT_12HOUR and FORMAT_24HOUR are set, then 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * FORMAT_24HOUR takes precedence. 105199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_24HOUR is set and the time is shown, then the time is 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown in the 24-hour time format. You should not normally set this. 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Instead, let the time format be chosen automatically according to the 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * system settings. If both FORMAT_12HOUR and FORMAT_24HOUR are set, then 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * FORMAT_24HOUR takes precedence. 105899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 1060577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * If FORMAT_UTC is set, then the UTC time zone is used for the start 1061577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * and end milliseconds unless a time zone is specified. If a time zone 1062577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * is specified it will be used regardless of the FORMAT_UTC flag. 106399a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_ABBREV_TIME is set and 12-hour time format is used, then the 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * start and end times (if shown) are abbreviated by not showing the minutes 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if they are zero. For example, instead of "3:00pm" the time would be 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * abbreviated to "3pm". 106999a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_ABBREV_WEEKDAY is set, then the weekday (if shown) is 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * abbreviated to a 3-letter string. 107399a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_ABBREV_MONTH is set, then the month (if shown) is abbreviated 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to a 3-letter string. 107799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_ABBREV_ALL is set, then the weekday and the month (if shown) 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are abbreviated to 3-letter strings. 108199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If FORMAT_NUMERIC_DATE is set, then the date is shown in numeric format 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instead of using the name of the month. For example, "12/31/2008" 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instead of "December 31, 2008". 108699a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 108799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * <p> 108899a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * If the end date ends at 12:00am at the beginning of a day, it is 108999a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * formatted as the end of the previous day in two scenarios: 109099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * <ul> 109199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * <li>For single day events. This results in "8pm - midnight" instead of 109299a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * "Nov 10, 8pm - Nov 11, 12am".</li> 109399a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * <li>When the time is not displayed. This results in "Nov 10 - 11" for 109499a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * an event with a start date of Nov 10 and an end date of Nov 12 at 109599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 00:00.</li> 109699a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * </ul> 109799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context the context is required only if the time is shown 1099becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @param formatter the Formatter used for formatting the date range. 1100becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * Note: be sure to call setLength(0) on StringBuilder passed to 1101becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * the Formatter constructor unless you want the results to accumulate. 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startMillis the start time in UTC milliseconds 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param endMillis the end time in UTC milliseconds 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags a bit mask of options 1105577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * @param timeZone the time zone to compute the string in. Use null for local 1106577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik * or if the FORMAT_UTC flag is being used. 110799a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 1108becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan * @return the formatter with the formatted date/time range appended to the string buffer. 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1110becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan public static Formatter formatDateRange(Context context, Formatter formatter, long startMillis, 1111577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik long endMillis, int flags, String timeZone) { 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Resources res = Resources.getSystem(); 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean showTime = (flags & FORMAT_SHOW_TIME) != 0; 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean showWeekDay = (flags & FORMAT_SHOW_WEEKDAY) != 0; 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean showYear = (flags & FORMAT_SHOW_YEAR) != 0; 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean noYear = (flags & FORMAT_NO_YEAR) != 0; 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean useUTC = (flags & FORMAT_UTC) != 0; 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean abbrevWeekDay = (flags & (FORMAT_ABBREV_WEEKDAY | FORMAT_ABBREV_ALL)) != 0; 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean abbrevMonth = (flags & (FORMAT_ABBREV_MONTH | FORMAT_ABBREV_ALL)) != 0; 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean noMonthDay = (flags & FORMAT_NO_MONTH_DAY) != 0; 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean numericDate = (flags & FORMAT_NUMERIC_DATE) != 0; 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // If we're getting called with a single instant in time (from 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // e.g. formatDateTime(), below), then we can skip a lot of 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // computation below that'd otherwise be thrown out. 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isInstant = (startMillis == endMillis); 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1128577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik Time startDate; 1129577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik if (timeZone != null) { 1130577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik startDate = new Time(timeZone); 1131577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } else if (useUTC) { 1132577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik startDate = new Time(Time.TIMEZONE_UTC); 1133577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } else { 1134577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik startDate = new Time(); 1135577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startDate.set(startMillis); 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Time endDate; 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int dayDistance; 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (isInstant) { 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endDate = startDate; 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dayDistance = 0; 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1144577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik if (timeZone != null) { 1145577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik endDate = new Time(timeZone); 1146577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } else if (useUTC) { 1147577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik endDate = new Time(Time.TIMEZONE_UTC); 1148577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } else { 1149577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik endDate = new Time(); 1150577ec9eb3a661de96a2cbe9ec918eda082fb7659Erik } 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endDate.set(endMillis); 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startJulianDay = Time.getJulianDay(startMillis, startDate.gmtoff); 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int endJulianDay = Time.getJulianDay(endMillis, endDate.gmtoff); 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dayDistance = endJulianDay - startJulianDay; 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isInstant 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (endDate.hour | endDate.minute | endDate.second) == 0 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (!showTime || dayDistance <= 1)) { 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endDate.monthDay -= 1; 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endDate.normalize(true /* ignore isDst */); 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startDay = startDate.monthDay; 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startMonthNum = startDate.month; 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startYear = startDate.year; 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int endDay = endDate.monthDay; 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int endMonthNum = endDate.month; 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int endYear = endDate.year; 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startWeekDayString = ""; 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endWeekDayString = ""; 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showWeekDay) { 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String weekDayFormat = ""; 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevWeekDay) { 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project weekDayFormat = ABBREV_WEEKDAY_FORMAT; 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project weekDayFormat = WEEKDAY_FORMAT; 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startWeekDayString = startDate.format(weekDayFormat); 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endWeekDayString = isInstant ? startWeekDayString : endDate.format(weekDayFormat); 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startTimeString = ""; 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endTimeString = ""; 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startTimeFormat = ""; 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endTimeFormat = ""; 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean force24Hour = (flags & FORMAT_24HOUR) != 0; 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean force12Hour = (flags & FORMAT_12HOUR) != 0; 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean use24Hour; 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (force24Hour) { 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project use24Hour = true; 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (force12Hour) { 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project use24Hour = false; 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project use24Hour = DateFormat.is24HourFormat(context); 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (use24Hour) { 120184c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer startTimeFormat = endTimeFormat = 120284c863d9af1270a2ccd2ccd2b8c1a753826dfe6dEric Fischer res.getString(com.android.internal.R.string.hour_minute_24); 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean abbrevTime = (flags & (FORMAT_ABBREV_TIME | FORMAT_ABBREV_ALL)) != 0; 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean capAMPM = (flags & FORMAT_CAP_AMPM) != 0; 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean noNoon = (flags & FORMAT_NO_NOON) != 0; 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean capNoon = (flags & FORMAT_CAP_NOON) != 0; 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean noMidnight = (flags & FORMAT_NO_MIDNIGHT) != 0; 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean capMidnight = (flags & FORMAT_CAP_MIDNIGHT) != 0; 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean startOnTheHour = startDate.minute == 0 && startDate.second == 0; 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean endOnTheHour = endDate.minute == 0 && endDate.second == 0; 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevTime && startOnTheHour) { 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capAMPM) { 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.hour_cap_ampm); 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.hour_ampm); 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capAMPM) { 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.hour_minute_cap_ampm); 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.hour_minute_ampm); 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Don't waste time on setting endTimeFormat when 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we're dealing with an instant, where we'll never 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // need the end point. (It's the same as the start 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // point) 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isInstant) { 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevTime && endOnTheHour) { 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capAMPM) { 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.hour_cap_ampm); 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.hour_ampm); 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capAMPM) { 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.hour_minute_cap_ampm); 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.hour_minute_ampm); 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (endDate.hour == 12 && endOnTheHour && !noNoon) { 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capNoon) { 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.Noon); 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.noon); 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (endDate.hour == 0 && endOnTheHour && !noMidnight) { 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capMidnight) { 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.Midnight); 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeFormat = res.getString(com.android.internal.R.string.midnight); 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (startDate.hour == 12 && startOnTheHour && !noNoon) { 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (capNoon) { 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.Noon); 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeFormat = res.getString(com.android.internal.R.string.noon); 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Don't show the start time starting at midnight. Show 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // 12am instead. 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startTimeString = startDate.format(startTimeFormat); 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endTimeString = isInstant ? startTimeString : endDate.format(endTimeFormat); 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Show the year if the user specified FORMAT_SHOW_YEAR or if 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the starting and end years are different from each other 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // or from the current year. But don't show the year if the 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // user specified FORMAT_NO_YEAR. 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showYear) { 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // No code... just a comment for clarity. Keep showYear 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // on, as they enabled it with FORMAT_SHOW_YEAR. This 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // takes precedence over them setting FORMAT_NO_YEAR. 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (noYear) { 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // They explicitly didn't want a year. 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project showYear = false; 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (startYear != endYear) { 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project showYear = true; 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Show the year if it's not equal to the current year. 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Time currentTime = new Time(); 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project currentTime.setToNow(); 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project showYear = startYear != currentTime.year; 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String defaultDateFormat, fullFormat, dateRange; 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (numericDate) { 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.numeric_date); 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (showYear) { 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevMonth) { 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (noMonthDay) { 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.abbrev_month_year); 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.abbrev_month_day_year); 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (noMonthDay) { 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.month_year); 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.month_day_year); 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (abbrevMonth) { 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (noMonthDay) { 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.abbrev_month); 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.abbrev_month_day); 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (noMonthDay) { 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.month); 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project defaultDateFormat = res.getString(com.android.internal.R.string.month_day); 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showWeekDay) { 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.wday1_date1_time1_wday2_date2_time2); 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.wday1_date1_wday2_date2); 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.date1_time1_date2_time2); 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.date1_date2); 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1343b193e35ed131769e6c98b2752635065489198aebOwen Lin if (noMonthDay && startMonthNum == endMonthNum && startYear == endYear) { 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "January, 2008" 1345becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format("%s", startDate.format(defaultDateFormat)); 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (startYear != endYear || noMonthDay) { 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Different year or we are not showing the month day number. 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "December 31, 2007 - January 1, 2008" 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Or: "January - February, 2008" 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startDateString = startDate.format(defaultDateFormat); 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endDateString = endDate.format(defaultDateFormat); 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The values that are used in a fullFormat string are specified 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // by position. 1357becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format(fullFormat, 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startWeekDayString, startDateString, startTimeString, 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endWeekDayString, endDateString, endTimeString); 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Get the month, day, and year strings for the start and end dates 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String monthFormat; 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (numericDate) { 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project monthFormat = NUMERIC_MONTH_FORMAT; 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (abbrevMonth) { 13675669ce59aad19f17e1e89913e7483fb93b8aa0cfEric Fischer monthFormat = 13685669ce59aad19f17e1e89913e7483fb93b8aa0cfEric Fischer res.getString(com.android.internal.R.string.short_format_month); 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project monthFormat = MONTH_FORMAT; 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startMonthString = startDate.format(monthFormat); 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startMonthDayString = startDate.format(MONTH_DAY_FORMAT); 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String startYearString = startDate.format(YEAR_FORMAT); 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endMonthString = isInstant ? null : endDate.format(monthFormat); 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endMonthDayString = isInstant ? null : endDate.format(MONTH_DAY_FORMAT); 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String endYearString = isInstant ? null : endDate.format(YEAR_FORMAT); 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13809ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes String startStandaloneMonthString = startMonthString; 13819ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes String endStandaloneMonthString = endMonthString; 13829ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes // We need standalone months for these strings in Persian (fa): http://b/6811327 13839ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes if (!numericDate && !abbrevMonth && Locale.getDefault().getLanguage().equals("fa")) { 13849ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes startStandaloneMonthString = startDate.format("%-B"); 13859ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes endStandaloneMonthString = endDate.format("%-B"); 13869ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes } 13879ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (startMonthNum != endMonthNum) { 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Same year, different month. 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "October 28 - November 3" 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // or: "Wed, Oct 31 - Sat, Nov 3, 2007" 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // or: "Oct 31, 8am - Sat, Nov 3, 2007, 5pm" 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index = 0; 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showWeekDay) index = 1; 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showYear) index += 2; 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) index += 4; 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (numericDate) index += 8; 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resId = sameYearTable[index]; 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(resId); 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The values that are used in a fullFormat string are specified 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // by position. 1404becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format(fullFormat, 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startWeekDayString, startMonthString, startMonthDayString, 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startYearString, startTimeString, 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endWeekDayString, endMonthString, endMonthDayString, 14089ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes endYearString, endTimeString, 14099ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes startStandaloneMonthString, endStandaloneMonthString); 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (startDay != endDay) { 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Same month, different day. 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index = 0; 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showWeekDay) index = 1; 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showYear) index += 2; 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) index += 4; 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (numericDate) index += 8; 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resId = sameMonthTable[index]; 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(resId); 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The values that are used in a fullFormat string are specified 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // by position. 1424becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format(fullFormat, 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startWeekDayString, startMonthString, startMonthDayString, 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project startYearString, startTimeString, 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project endWeekDayString, endMonthString, endMonthDayString, 14289ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes endYearString, endTimeString, 14299ccf13cd6b7c840105fbcd6b2a8bd61d4e634653Elliott Hughes startStandaloneMonthString, endStandaloneMonthString); 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Same start and end day 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean showDate = (flags & FORMAT_SHOW_DATE) != 0; 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // If nothing was specified, then show the date. 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!showTime && !showDate && !showWeekDay) showDate = true; 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Compute the time string (example: "10:00 - 11:00 am") 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String timeString = ""; 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // If the start and end time are the same, then just show the 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // start time. 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (isInstant) { 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Same start and end time. 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "10:15 AM" 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project timeString = startTimeString; 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "10:00 - 11:00 am" 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String timeFormat = res.getString(com.android.internal.R.string.time1_time2); 1450becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan // Don't use the user supplied Formatter because the result will pollute the buffer. 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project timeString = String.format(timeFormat, startTimeString, endTimeString); 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Figure out which full format to use. 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = ""; 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String dateString = ""; 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showDate) { 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dateString = startDate.format(defaultDateFormat); 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showWeekDay) { 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "10:00 - 11:00 am, Tue, Oct 9" 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.time_wday_date); 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "Tue, Oct 9" 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.wday_date); 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "10:00 - 11:00 am, Oct 9" 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.time_date); 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "Oct 9" 1474becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format("%s", dateString); 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (showWeekDay) { 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (showTime) { 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "10:00 - 11:00 am, Tue" 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fullFormat = res.getString(com.android.internal.R.string.time_wday); 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Example: "Tue" 1483becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format("%s", startWeekDayString); 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (showTime) { 1486becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format("%s", timeString); 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The values that are used in a fullFormat string are specified 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // by position. 1491becfc9de9e18ef216c2b537cd2829f1d2d55404fMichael Chan return formatter.format(fullFormat, timeString, startWeekDayString, dateString); 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Formats a date or a time according to the local conventions. There are 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lots of options that allow the caller to control, for example, if the 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * time is shown, if the day of the week is shown, if the month name is 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * abbreviated, if noon is shown instead of 12pm, and so on. For the 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * complete list of options, see the documentation for 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #formatDateRange}. 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example output strings (date formats in these examples are shown using 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the US date format convention but that may change depending on the 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * local settings): 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>10:15am</li> 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3:00pm</li> 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3pm</li> 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>3PM</li> 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>08:00</li> 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>17:00</li> 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>noon</li> 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Noon</li> 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>midnight</li> 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Midnight</li> 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 31</li> 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Oct 31, 2007</li> 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>October 31, 2007</li> 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>10am, Oct 31</li> 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>17:00, Oct 31</li> 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wed</li> 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wednesday</li> 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>10am, Wed, Oct 31</li> 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wed, Oct 31</li> 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wednesday, Oct 31</li> 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wed, Oct 31, 2007</li> 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Wed, October 31</li> 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>10/31/2007</li> 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 153099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context the context is required only if the time is shown 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param millis a point in time in UTC milliseconds 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags a bit mask of formatting options 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a string containing the formatted date/time. 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String formatDateTime(Context context, long millis, int flags) { 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return formatDateRange(context, millis, millis, flags); 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a relative time string to display the time expressed by millis. Times 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are counted starting at midnight, which means that assuming that the current 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * time is March 31st, 0:30: 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 154599a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * <li>"millis=0:10 today" will be displayed as "0:10"</li> 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>"millis=11:30pm the day before" will be displayed as "Mar 30"</li> 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the given millis is in a different year, then the full date is 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned in numeric format (e.g., "10/12/2008"). 155099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * 155199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * @param withPreposition If true, the string returned will include the correct 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * preposition ("at 9:20am", "on 10/12/2008" or "on May 29"). 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static CharSequence getRelativeTimeSpanString(Context c, long millis, 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean withPreposition) { 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15576a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques String result; 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long now = System.currentTimeMillis(); 1559ca3363775e03e0f90bdf111d3e5c54b3ab16df57Steve Pomeroy long span = Math.abs(now - millis); 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15616a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques synchronized (DateUtils.class) { 15626a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques if (sNowTime == null) { 15636a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sNowTime = new Time(); 15646a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15666a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques if (sThenTime == null) { 15676a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sThenTime = new Time(); 15686a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15706a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sNowTime.set(now); 15716a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques sThenTime.set(millis); 15726a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques 15736a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques int prepositionId; 15746a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques if (span < DAY_IN_MILLIS && sNowTime.weekDay == sThenTime.weekDay) { 15756a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques // Same day 15766a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques int flags = FORMAT_SHOW_TIME; 15776a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques result = formatDateRange(c, millis, millis, flags); 15786a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques prepositionId = R.string.preposition_for_time; 15796a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } else if (sNowTime.year != sThenTime.year) { 15806a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques // Different years 15816a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques int flags = FORMAT_SHOW_DATE | FORMAT_SHOW_YEAR | FORMAT_NUMERIC_DATE; 15826a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques result = formatDateRange(c, millis, millis, flags); 15836a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques 15846a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques // This is a date (like "10/31/2008" so use the date preposition) 15856a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques prepositionId = R.string.preposition_for_date; 15866a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } else { 15876a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques // Default 15886a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques int flags = FORMAT_SHOW_DATE | FORMAT_ABBREV_MONTH; 15896a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques result = formatDateRange(c, millis, millis, flags); 15906a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques prepositionId = R.string.preposition_for_date; 15916a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } 15926a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques if (withPreposition) { 15936a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques Resources res = c.getResources(); 15946a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques result = res.getString(prepositionId, result); 15956a84af0949b341593b4b25ed9bb365bd60ff1254David Sobreira Marques } 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return result; 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 159999a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 160199a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson * Convenience function to return relative time string without preposition. 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param c context for resources 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param millis time in milliseconds 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link CharSequence} containing relative time. 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRelativeTimeSpanString(Context, long, boolean) 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static CharSequence getRelativeTimeSpanString(Context c, long millis) { 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getRelativeTimeSpanString(c, millis, false /* no preposition */); 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 161099a64f4b1d2519b71558fdc62721686445865b60Jesse Wilson 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static Time sNowTime; 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static Time sThenTime; 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1614