| /* |
| * Copyright (C) 2010 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package android.widget; |
| |
| import static android.text.format.DateUtils.DAY_IN_MILLIS; |
| import static android.text.format.DateUtils.HOUR_IN_MILLIS; |
| import static android.text.format.DateUtils.MINUTE_IN_MILLIS; |
| import static android.text.format.DateUtils.YEAR_IN_MILLIS; |
| import static android.text.format.Time.getJulianDay; |
| |
| import android.app.ActivityThread; |
| import android.content.BroadcastReceiver; |
| import android.content.Context; |
| import android.content.Intent; |
| import android.content.IntentFilter; |
| import android.content.res.Configuration; |
| import android.content.res.TypedArray; |
| import android.database.ContentObserver; |
| import android.icu.util.Calendar; |
| import android.os.Handler; |
| import android.text.format.Time; |
| import android.util.AttributeSet; |
| import android.view.accessibility.AccessibilityNodeInfo; |
| import android.widget.RemoteViews.RemoteView; |
| |
| import com.android.internal.R; |
| |
| import java.text.DateFormat; |
| import java.util.ArrayList; |
| import java.util.Date; |
| import java.util.TimeZone; |
| |
| // |
| // TODO |
| // - listen for the next threshold time to update the view. |
| // - listen for date format pref changed |
| // - put the AM/PM in a smaller font |
| // |
| |
| /** |
| * Displays a given time in a convenient human-readable foramt. |
| * |
| * @hide |
| */ |
| @RemoteView |
| public class DateTimeView extends TextView { |
| private static final int SHOW_TIME = 0; |
| private static final int SHOW_MONTH_DAY_YEAR = 1; |
| |
| Date mTime; |
| long mTimeMillis; |
| |
| int mLastDisplay = -1; |
| DateFormat mLastFormat; |
| |
| private long mUpdateTimeMillis; |
| private static final ThreadLocal<ReceiverInfo> sReceiverInfo = new ThreadLocal<ReceiverInfo>(); |
| private String mNowText; |
| private boolean mShowRelativeTime; |
| |
| public DateTimeView(Context context) { |
| this(context, null); |
| } |
| |
| public DateTimeView(Context context, AttributeSet attrs) { |
| super(context, attrs); |
| final TypedArray a = context.obtainStyledAttributes(attrs, |
| com.android.internal.R.styleable.DateTimeView, 0, |
| 0); |
| |
| final int N = a.getIndexCount(); |
| for (int i = 0; i < N; i++) { |
| int attr = a.getIndex(i); |
| switch (attr) { |
| case R.styleable.DateTimeView_showRelative: |
| boolean relative = a.getBoolean(i, false); |
| setShowRelativeTime(relative); |
| break; |
| } |
| } |
| a.recycle(); |
| } |
| |
| @Override |
| protected void onAttachedToWindow() { |
| super.onAttachedToWindow(); |
| ReceiverInfo ri = sReceiverInfo.get(); |
| if (ri == null) { |
| ri = new ReceiverInfo(); |
| sReceiverInfo.set(ri); |
| } |
| ri.addView(this); |
| } |
| |
| @Override |
| protected void onDetachedFromWindow() { |
| super.onDetachedFromWindow(); |
| final ReceiverInfo ri = sReceiverInfo.get(); |
| if (ri != null) { |
| ri.removeView(this); |
| } |
| } |
| |
| @android.view.RemotableViewMethod |
| public void setTime(long time) { |
| Time t = new Time(); |
| t.set(time); |
| mTimeMillis = t.toMillis(false); |
| mTime = new Date(t.year-1900, t.month, t.monthDay, t.hour, t.minute, 0); |
| update(); |
| } |
| |
| @android.view.RemotableViewMethod |
| public void setShowRelativeTime(boolean showRelativeTime) { |
| mShowRelativeTime = showRelativeTime; |
| updateNowText(); |
| update(); |
| } |
| |
| @Override |
| @android.view.RemotableViewMethod |
| public void setVisibility(@Visibility int visibility) { |
| boolean gotVisible = visibility != GONE && getVisibility() == GONE; |
| super.setVisibility(visibility); |
| if (gotVisible) { |
| update(); |
| } |
| } |
| |
| void update() { |
| if (mTime == null || getVisibility() == GONE) { |
| return; |
| } |
| if (mShowRelativeTime) { |
| updateRelativeTime(); |
| return; |
| } |
| |
| int display; |
| Date time = mTime; |
| |
| Time t = new Time(); |
| t.set(mTimeMillis); |
| t.second = 0; |
| |
| t.hour -= 12; |
| long twelveHoursBefore = t.toMillis(false); |
| t.hour += 12; |
| long twelveHoursAfter = t.toMillis(false); |
| t.hour = 0; |
| t.minute = 0; |
| long midnightBefore = t.toMillis(false); |
| t.monthDay++; |
| long midnightAfter = t.toMillis(false); |
| |
| long nowMillis = System.currentTimeMillis(); |
| t.set(nowMillis); |
| t.second = 0; |
| nowMillis = t.normalize(false); |
| |
| // Choose the display mode |
| choose_display: { |
| if ((nowMillis >= midnightBefore && nowMillis < midnightAfter) |
| || (nowMillis >= twelveHoursBefore && nowMillis < twelveHoursAfter)) { |
| display = SHOW_TIME; |
| break choose_display; |
| } |
| // Else, show month day and year. |
| display = SHOW_MONTH_DAY_YEAR; |
| break choose_display; |
| } |
| |
| // Choose the format |
| DateFormat format; |
| if (display == mLastDisplay && mLastFormat != null) { |
| // use cached format |
| format = mLastFormat; |
| } else { |
| switch (display) { |
| case SHOW_TIME: |
| format = getTimeFormat(); |
| break; |
| case SHOW_MONTH_DAY_YEAR: |
| format = DateFormat.getDateInstance(DateFormat.SHORT); |
| break; |
| default: |
| throw new RuntimeException("unknown display value: " + display); |
| } |
| mLastFormat = format; |
| } |
| |
| // Set the text |
| String text = format.format(mTime); |
| setText(text); |
| |
| // Schedule the next update |
| if (display == SHOW_TIME) { |
| // Currently showing the time, update at the later of twelve hours after or midnight. |
| mUpdateTimeMillis = twelveHoursAfter > midnightAfter ? twelveHoursAfter : midnightAfter; |
| } else { |
| // Currently showing the date |
| if (mTimeMillis < nowMillis) { |
| // If the time is in the past, don't schedule an update |
| mUpdateTimeMillis = 0; |
| } else { |
| // If hte time is in the future, schedule one at the earlier of twelve hours |
| // before or midnight before. |
| mUpdateTimeMillis = twelveHoursBefore < midnightBefore |
| ? twelveHoursBefore : midnightBefore; |
| } |
| } |
| } |
| |
| private void updateRelativeTime() { |
| long now = System.currentTimeMillis(); |
| long duration = Math.abs(now - mTimeMillis); |
| int count; |
| long millisIncrease; |
| boolean past = (now >= mTimeMillis); |
| String result; |
| if (duration < MINUTE_IN_MILLIS) { |
| setText(mNowText); |
| mUpdateTimeMillis = mTimeMillis + MINUTE_IN_MILLIS + 1; |
| return; |
| } else if (duration < HOUR_IN_MILLIS) { |
| count = (int)(duration / MINUTE_IN_MILLIS); |
| result = String.format(getContext().getResources().getQuantityString(past |
| ? com.android.internal.R.plurals.duration_minutes_shortest |
| : com.android.internal.R.plurals.duration_minutes_shortest_future, |
| count), |
| count); |
| millisIncrease = MINUTE_IN_MILLIS; |
| } else if (duration < DAY_IN_MILLIS) { |
| count = (int)(duration / HOUR_IN_MILLIS); |
| result = String.format(getContext().getResources().getQuantityString(past |
| ? com.android.internal.R.plurals.duration_hours_shortest |
| : com.android.internal.R.plurals.duration_hours_shortest_future, |
| count), |
| count); |
| millisIncrease = HOUR_IN_MILLIS; |
| } else if (duration < YEAR_IN_MILLIS) { |
| // In weird cases it can become 0 because of daylight savings |
| TimeZone timeZone = TimeZone.getDefault(); |
| count = Math.max(Math.abs(dayDistance(timeZone, mTimeMillis, now)), 1); |
| result = String.format(getContext().getResources().getQuantityString(past |
| ? com.android.internal.R.plurals.duration_days_shortest |
| : com.android.internal.R.plurals.duration_days_shortest_future, |
| count), |
| count); |
| if (past || count != 1) { |
| mUpdateTimeMillis = computeNextMidnight(timeZone); |
| millisIncrease = -1; |
| } else { |
| millisIncrease = DAY_IN_MILLIS; |
| } |
| |
| } else { |
| count = (int)(duration / YEAR_IN_MILLIS); |
| result = String.format(getContext().getResources().getQuantityString(past |
| ? com.android.internal.R.plurals.duration_years_shortest |
| : com.android.internal.R.plurals.duration_years_shortest_future, |
| count), |
| count); |
| millisIncrease = YEAR_IN_MILLIS; |
| } |
| if (millisIncrease != -1) { |
| if (past) { |
| mUpdateTimeMillis = mTimeMillis + millisIncrease * (count + 1) + 1; |
| } else { |
| mUpdateTimeMillis = mTimeMillis - millisIncrease * count + 1; |
| } |
| } |
| setText(result); |
| } |
| |
| /** |
| * @param timeZone the timezone we are in |
| * @return the timepoint in millis at UTC at midnight in the current timezone |
| */ |
| private long computeNextMidnight(TimeZone timeZone) { |
| Calendar c = Calendar.getInstance(); |
| c.setTimeZone(libcore.icu.DateUtilsBridge.icuTimeZone(timeZone)); |
| c.add(Calendar.DAY_OF_MONTH, 1); |
| c.set(Calendar.HOUR_OF_DAY, 0); |
| c.set(Calendar.MINUTE, 0); |
| c.set(Calendar.SECOND, 0); |
| c.set(Calendar.MILLISECOND, 0); |
| return c.getTimeInMillis(); |
| } |
| |
| @Override |
| protected void onConfigurationChanged(Configuration newConfig) { |
| super.onConfigurationChanged(newConfig); |
| updateNowText(); |
| update(); |
| } |
| |
| private void updateNowText() { |
| if (!mShowRelativeTime) { |
| return; |
| } |
| mNowText = getContext().getResources().getString( |
| com.android.internal.R.string.now_string_shortest); |
| } |
| |
| // Return the date difference for the two times in a given timezone. |
| private static int dayDistance(TimeZone timeZone, long startTime, |
| long endTime) { |
| return getJulianDay(endTime, timeZone.getOffset(endTime) / 1000) |
| - getJulianDay(startTime, timeZone.getOffset(startTime) / 1000); |
| } |
| |
| private DateFormat getTimeFormat() { |
| return android.text.format.DateFormat.getTimeFormat(getContext()); |
| } |
| |
| void clearFormatAndUpdate() { |
| mLastFormat = null; |
| update(); |
| } |
| |
| @Override |
| public void onInitializeAccessibilityNodeInfoInternal(AccessibilityNodeInfo info) { |
| super.onInitializeAccessibilityNodeInfoInternal(info); |
| if (mShowRelativeTime) { |
| // The short version of the time might not be completely understandable and for |
| // accessibility we rather have a longer version. |
| long now = System.currentTimeMillis(); |
| long duration = Math.abs(now - mTimeMillis); |
| int count; |
| boolean past = (now >= mTimeMillis); |
| String result; |
| if (duration < MINUTE_IN_MILLIS) { |
| result = mNowText; |
| } else if (duration < HOUR_IN_MILLIS) { |
| count = (int)(duration / MINUTE_IN_MILLIS); |
| result = String.format(getContext().getResources().getQuantityString(past |
| ? com.android.internal. |
| R.plurals.duration_minutes_relative |
| : com.android.internal. |
| R.plurals.duration_minutes_relative_future, |
| count), |
| count); |
| } else if (duration < DAY_IN_MILLIS) { |
| count = (int)(duration / HOUR_IN_MILLIS); |
| result = String.format(getContext().getResources().getQuantityString(past |
| ? com.android.internal. |
| R.plurals.duration_hours_relative |
| : com.android.internal. |
| R.plurals.duration_hours_relative_future, |
| count), |
| count); |
| } else if (duration < YEAR_IN_MILLIS) { |
| // In weird cases it can become 0 because of daylight savings |
| TimeZone timeZone = TimeZone.getDefault(); |
| count = Math.max(Math.abs(dayDistance(timeZone, mTimeMillis, now)), 1); |
| result = String.format(getContext().getResources().getQuantityString(past |
| ? com.android.internal. |
| R.plurals.duration_days_relative |
| : com.android.internal. |
| R.plurals.duration_days_relative_future, |
| count), |
| count); |
| |
| } else { |
| count = (int)(duration / YEAR_IN_MILLIS); |
| result = String.format(getContext().getResources().getQuantityString(past |
| ? com.android.internal. |
| R.plurals.duration_years_relative |
| : com.android.internal. |
| R.plurals.duration_years_relative_future, |
| count), |
| count); |
| } |
| info.setText(result); |
| } |
| } |
| |
| /** |
| * @hide |
| */ |
| public static void setReceiverHandler(Handler handler) { |
| ReceiverInfo ri = sReceiverInfo.get(); |
| if (ri == null) { |
| ri = new ReceiverInfo(); |
| sReceiverInfo.set(ri); |
| } |
| ri.setHandler(handler); |
| } |
| |
| private static class ReceiverInfo { |
| private final ArrayList<DateTimeView> mAttachedViews = new ArrayList<DateTimeView>(); |
| private final BroadcastReceiver mReceiver = new BroadcastReceiver() { |
| @Override |
| public void onReceive(Context context, Intent intent) { |
| String action = intent.getAction(); |
| if (Intent.ACTION_TIME_TICK.equals(action)) { |
| if (System.currentTimeMillis() < getSoonestUpdateTime()) { |
| // The update() function takes a few milliseconds to run because of |
| // all of the time conversions it needs to do, so we can't do that |
| // every minute. |
| return; |
| } |
| } |
| // ACTION_TIME_CHANGED can also signal a change of 12/24 hr. format. |
| updateAll(); |
| } |
| }; |
| |
| private final ContentObserver mObserver = new ContentObserver(new Handler()) { |
| @Override |
| public void onChange(boolean selfChange) { |
| updateAll(); |
| } |
| }; |
| |
| private Handler mHandler = new Handler(); |
| |
| public void addView(DateTimeView v) { |
| synchronized (mAttachedViews) { |
| final boolean register = mAttachedViews.isEmpty(); |
| mAttachedViews.add(v); |
| if (register) { |
| register(getApplicationContextIfAvailable(v.getContext())); |
| } |
| } |
| } |
| |
| public void removeView(DateTimeView v) { |
| synchronized (mAttachedViews) { |
| mAttachedViews.remove(v); |
| if (mAttachedViews.isEmpty()) { |
| unregister(getApplicationContextIfAvailable(v.getContext())); |
| } |
| } |
| } |
| |
| void updateAll() { |
| synchronized (mAttachedViews) { |
| final int count = mAttachedViews.size(); |
| for (int i = 0; i < count; i++) { |
| DateTimeView view = mAttachedViews.get(i); |
| view.post(() -> view.clearFormatAndUpdate()); |
| } |
| } |
| } |
| |
| long getSoonestUpdateTime() { |
| long result = Long.MAX_VALUE; |
| synchronized (mAttachedViews) { |
| final int count = mAttachedViews.size(); |
| for (int i = 0; i < count; i++) { |
| final long time = mAttachedViews.get(i).mUpdateTimeMillis; |
| if (time < result) { |
| result = time; |
| } |
| } |
| } |
| return result; |
| } |
| |
| static final Context getApplicationContextIfAvailable(Context context) { |
| final Context ac = context.getApplicationContext(); |
| return ac != null ? ac : ActivityThread.currentApplication().getApplicationContext(); |
| } |
| |
| void register(Context context) { |
| final IntentFilter filter = new IntentFilter(); |
| filter.addAction(Intent.ACTION_TIME_TICK); |
| filter.addAction(Intent.ACTION_TIME_CHANGED); |
| filter.addAction(Intent.ACTION_CONFIGURATION_CHANGED); |
| filter.addAction(Intent.ACTION_TIMEZONE_CHANGED); |
| context.registerReceiver(mReceiver, filter, null, mHandler); |
| } |
| |
| void unregister(Context context) { |
| context.unregisterReceiver(mReceiver); |
| } |
| |
| public void setHandler(Handler handler) { |
| mHandler = handler; |
| synchronized (mAttachedViews) { |
| if (!mAttachedViews.isEmpty()) { |
| unregister(mAttachedViews.get(0).getContext()); |
| register(mAttachedViews.get(0).getContext()); |
| } |
| } |
| } |
| } |
| } |