TimePicker

Added in 1.1.0

Kotlin |Java

public class TimePicker extends Picker

java.lang.Object
↳	android.view.View
	↳	android.view.ViewGroup
		↳	android.widget.FrameLayout
			↳	androidx.leanback.widget.picker.Picker
				↳	androidx.leanback.widget.picker.TimePicker

TimePicker is a direct subclass of Picker.

This class is a widget for selecting time and displays it according to the formatting for the current system locale. The time can be selected by hour, minute, and AM/PM picker columns. The AM/PM mode is determined by either explicitly setting the current mode through setIs24Hour or the widget attribute is24HourFormat (true for 24-hour mode, false for 12-hour mode). Otherwise, TimePicker retrieves the mode based on the current context. In 24-hour mode, TimePicker displays only the hour and minute columns.

This widget can show the current time as the initial value if useCurrentTime is set to true. Each individual time picker field can be set at any time by calling setHour, setMinute using 24-hour time format. The time format can also be changed at any time by calling setIs24Hour, and the AM/PM picker column will be activated or deactivated accordingly. is24HourFormatuseCurrentTime

Summary

Public constructors
`TimePicker(Context context, AttributeSet attrs)` Constructor called when inflating a TimePicker widget.
`TimePicker(Context context, AttributeSet attrs, int defStyleAttr)` Constructor called when inflating a TimePicker widget.

Public methods
`int`	`getHour()` Returns the currently selected hour using 24-hour time.
`int`	`getMinute()` Returns the currently selected minute.
`boolean`	`is24Hour()`
`boolean`	`isPm()` Only meaningful for a 12-hour time.
`void`	`onColumnValueChanged(int columnIndex, int newValue)` Classes extending `Picker` can override this function to supply the behavior when a list has been scrolled.
`void`	`setHour(@IntRange(from = 0, to = 23) int hour)` Sets the currently selected hour using a 24-hour time.
`void`	`setIs24Hour(boolean is24Hour)` Sets whether this widget displays a 24-hour mode or a 12-hour mode with an AM/PM picker.
`void`	`setMinute(@IntRange(from = 0, to = 59) int minute)` Sets the currently selected minute.

Inherited Constants

From android.view.View

`static final int`	`ACCESSIBILITY_DATA_SENSITIVE_AUTO = 0`
`static final int`	`ACCESSIBILITY_DATA_SENSITIVE_NO = 2`
`static final int`	`ACCESSIBILITY_DATA_SENSITIVE_YES = 1`
`static final int`	`ACCESSIBILITY_LIVE_REGION_ASSERTIVE = 2`
`static final int`	`ACCESSIBILITY_LIVE_REGION_NONE = 0`
`static final int`	`ACCESSIBILITY_LIVE_REGION_POLITE = 1`
`static final Property<View, Float>`	`ALPHA`
`static final int`	`AUTOFILL_FLAG_INCLUDE_NOT_IMPORTANT_VIEWS = 1`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DATE = "creditCardExpirationDate"`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DAY = "creditCardExpirationDay"`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_MONTH = "creditCardExpirationMonth"`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_YEAR = "creditCardExpirationYear"`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_NUMBER = "creditCardNumber"`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_SECURITY_CODE = "creditCardSecurityCode"`
`static final String`	`AUTOFILL_HINT_EMAIL_ADDRESS = "emailAddress"`
`static final String`	`AUTOFILL_HINT_NAME = "name"`
`static final String`	`AUTOFILL_HINT_PASSWORD = "password"`
`static final String`	`AUTOFILL_HINT_PHONE = "phone"`
`static final String`	`AUTOFILL_HINT_POSTAL_ADDRESS = "postalAddress"`
`static final String`	`AUTOFILL_HINT_POSTAL_CODE = "postalCode"`
`static final String`	`AUTOFILL_HINT_USERNAME = "username"`
`static final int`	`AUTOFILL_TYPE_DATE = 4`
`static final int`	`AUTOFILL_TYPE_LIST = 3`
`static final int`	`AUTOFILL_TYPE_NONE = 0`
`static final int`	`AUTOFILL_TYPE_TEXT = 1`
`static final int`	`AUTOFILL_TYPE_TOGGLE = 2`
`static final int`	`CONTENT_SENSITIVITY_AUTO = 0`
`static final int`	`CONTENT_SENSITIVITY_NOT_SENSITIVE = 2`
`static final int`	`CONTENT_SENSITIVITY_SENSITIVE = 1`
`static final int`	`DRAG_FLAG_ACCESSIBILITY_ACTION = 1024`
`static final int`	`DRAG_FLAG_GLOBAL = 256`
`static final int`	`DRAG_FLAG_GLOBAL_PERSISTABLE_URI_PERMISSION = 64`
`static final int`	`DRAG_FLAG_GLOBAL_PREFIX_URI_PERMISSION = 128`
`static final int`	`DRAG_FLAG_GLOBAL_SAME_APPLICATION = 4096`
`static final int`	`DRAG_FLAG_GLOBAL_URI_READ = 1`
`static final int`	`DRAG_FLAG_GLOBAL_URI_WRITE = 2`
`static final int`	`DRAG_FLAG_HIDE_CALLING_TASK_ON_DRAG_START = 16384`
`static final int`	`DRAG_FLAG_OPAQUE = 512`
`static final int`	`DRAG_FLAG_START_INTENT_SENDER_ON_UNHANDLED_DRAG = 8192`
`static final int`	`DRAWING_CACHE_QUALITY_AUTO = 0` This field is deprecated.
`static final int`	`DRAWING_CACHE_QUALITY_HIGH = 1048576` This field is deprecated.
`static final int`	`DRAWING_CACHE_QUALITY_LOW = 524288` This field is deprecated.
`static final int[]`	`EMPTY_STATE_SET`
`static final int[]`	`ENABLED_FOCUSED_SELECTED_STATE_SET`
`static final int[]`	`ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`ENABLED_FOCUSED_STATE_SET`
`static final int[]`	`ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`ENABLED_SELECTED_STATE_SET`
`static final int[]`	`ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`ENABLED_STATE_SET`
`static final int[]`	`ENABLED_WINDOW_FOCUSED_STATE_SET`
`static final int`	`FIND_VIEWS_WITH_CONTENT_DESCRIPTION = 2`
`static final int`	`FIND_VIEWS_WITH_TEXT = 1`
`static final int`	`FOCUSABLE = 1`
`static final int`	`FOCUSABLES_ALL = 0`
`static final int`	`FOCUSABLES_TOUCH_MODE = 1`
`static final int`	`FOCUSABLE_AUTO = 16`
`static final int[]`	`FOCUSED_SELECTED_STATE_SET`
`static final int[]`	`FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`FOCUSED_STATE_SET`
`static final int[]`	`FOCUSED_WINDOW_FOCUSED_STATE_SET`
`static final int`	`FOCUS_BACKWARD = 1`
`static final int`	`FOCUS_DOWN = 130`
`static final int`	`FOCUS_FORWARD = 2`
`static final int`	`FOCUS_LEFT = 17`
`static final int`	`FOCUS_RIGHT = 66`
`static final int`	`FOCUS_UP = 33`
`static final int`	`GONE = 8`
`static final int`	`HAPTIC_FEEDBACK_ENABLED = 268435456`
`static final int`	`IMPORTANT_FOR_ACCESSIBILITY_AUTO = 0`
`static final int`	`IMPORTANT_FOR_ACCESSIBILITY_NO = 2`
`static final int`	`IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS = 4`
`static final int`	`IMPORTANT_FOR_ACCESSIBILITY_YES = 1`
`static final int`	`IMPORTANT_FOR_AUTOFILL_AUTO = 0`
`static final int`	`IMPORTANT_FOR_AUTOFILL_NO = 2`
`static final int`	`IMPORTANT_FOR_AUTOFILL_NO_EXCLUDE_DESCENDANTS = 8`
`static final int`	`IMPORTANT_FOR_AUTOFILL_YES = 1`
`static final int`	`IMPORTANT_FOR_AUTOFILL_YES_EXCLUDE_DESCENDANTS = 4`
`static final int`	`IMPORTANT_FOR_CONTENT_CAPTURE_AUTO = 0`
`static final int`	`IMPORTANT_FOR_CONTENT_CAPTURE_NO = 2`
`static final int`	`IMPORTANT_FOR_CONTENT_CAPTURE_NO_EXCLUDE_DESCENDANTS = 8`
`static final int`	`IMPORTANT_FOR_CONTENT_CAPTURE_YES = 1`
`static final int`	`IMPORTANT_FOR_CONTENT_CAPTURE_YES_EXCLUDE_DESCENDANTS = 4`
`static final int`	`INVISIBLE = 4`
`static final int`	`KEEP_SCREEN_ON = 67108864`
`static final int`	`LAYER_TYPE_HARDWARE = 2`
`static final int`	`LAYER_TYPE_NONE = 0`
`static final int`	`LAYER_TYPE_SOFTWARE = 1`
`static final int`	`LAYOUT_DIRECTION_INHERIT = 2`
`static final int`	`LAYOUT_DIRECTION_LOCALE = 3`
`static final int`	`LAYOUT_DIRECTION_LTR = 0`
`static final int`	`LAYOUT_DIRECTION_RTL = 1`
`static final int`	`MEASURED_HEIGHT_STATE_SHIFT = 16`
`static final int`	`MEASURED_SIZE_MASK = 16777215`
`static final int`	`MEASURED_STATE_MASK = -16777216`
`static final int`	`MEASURED_STATE_TOO_SMALL = 16777216`
`static final int`	`NOT_FOCUSABLE = 0`
`static final int`	`NO_ID = -1`
`static final int`	`OVER_SCROLL_ALWAYS = 0`
`static final int`	`OVER_SCROLL_IF_CONTENT_SCROLLS = 1`
`static final int`	`OVER_SCROLL_NEVER = 2`
`static final int[]`	`PRESSED_ENABLED_FOCUSED_SELECTED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_SELECTED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_FOCUSED_SELECTED_STATE_SET`
`static final int[]`	`PRESSED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_FOCUSED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_SELECTED_STATE_SET`
`static final int[]`	`PRESSED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_STATE_SET`
`static final int[]`	`PRESSED_WINDOW_FOCUSED_STATE_SET`
`static final float`	`REQUESTED_FRAME_RATE_CATEGORY_DEFAULT`
`static final float`	`REQUESTED_FRAME_RATE_CATEGORY_HIGH = -4.0f`
`static final float`	`REQUESTED_FRAME_RATE_CATEGORY_LOW = -2.0f`
`static final float`	`REQUESTED_FRAME_RATE_CATEGORY_NORMAL = -3.0f`
`static final float`	`REQUESTED_FRAME_RATE_CATEGORY_NO_PREFERENCE = -1.0f`
`static final Property<View, Float>`	`ROTATION`
`static final Property<View, Float>`	`ROTATION_X`
`static final Property<View, Float>`	`ROTATION_Y`
`static final Property<View, Float>`	`SCALE_X`
`static final Property<View, Float>`	`SCALE_Y`
`static final int`	`SCREEN_STATE_OFF = 0`
`static final int`	`SCREEN_STATE_ON = 1`
`static final int`	`SCROLLBARS_INSIDE_INSET = 16777216`
`static final int`	`SCROLLBARS_INSIDE_OVERLAY = 0`
`static final int`	`SCROLLBARS_OUTSIDE_INSET = 50331648`
`static final int`	`SCROLLBARS_OUTSIDE_OVERLAY = 33554432`
`static final int`	`SCROLLBAR_POSITION_DEFAULT = 0`
`static final int`	`SCROLLBAR_POSITION_LEFT = 1`
`static final int`	`SCROLLBAR_POSITION_RIGHT = 2`
`static final int`	`SCROLL_AXIS_HORIZONTAL = 1`
`static final int`	`SCROLL_AXIS_NONE = 0`
`static final int`	`SCROLL_AXIS_VERTICAL = 2`
`static final int`	`SCROLL_CAPTURE_HINT_AUTO = 0`
`static final int`	`SCROLL_CAPTURE_HINT_EXCLUDE = 1`
`static final int`	`SCROLL_CAPTURE_HINT_EXCLUDE_DESCENDANTS = 4`
`static final int`	`SCROLL_CAPTURE_HINT_INCLUDE = 2`
`static final int`	`SCROLL_INDICATOR_BOTTOM = 2`
`static final int`	`SCROLL_INDICATOR_END = 32`
`static final int`	`SCROLL_INDICATOR_LEFT = 4`
`static final int`	`SCROLL_INDICATOR_RIGHT = 8`
`static final int`	`SCROLL_INDICATOR_START = 16`
`static final int`	`SCROLL_INDICATOR_TOP = 1`
`static final int[]`	`SELECTED_STATE_SET`
`static final int[]`	`SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int`	`SOUND_EFFECTS_ENABLED = 134217728`
`static final int`	`STATUS_BAR_HIDDEN = 1` This field is deprecated.
`static final int`	`STATUS_BAR_VISIBLE = 0` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_FULLSCREEN = 4` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_HIDE_NAVIGATION = 2` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_IMMERSIVE = 2048` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_IMMERSIVE_STICKY = 4096` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN = 1024` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION = 512` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LAYOUT_STABLE = 256` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR = 16` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LIGHT_STATUS_BAR = 8192` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LOW_PROFILE = 1` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_VISIBLE = 0` This field is deprecated.
`static final int`	`SYSTEM_UI_LAYOUT_FLAGS = 1536` This field is deprecated.
`static final int`	`TEXT_ALIGNMENT_CENTER = 4`
`static final int`	`TEXT_ALIGNMENT_GRAVITY = 1`
`static final int`	`TEXT_ALIGNMENT_INHERIT = 0`
`static final int`	`TEXT_ALIGNMENT_TEXT_END = 3`
`static final int`	`TEXT_ALIGNMENT_TEXT_START = 2`
`static final int`	`TEXT_ALIGNMENT_VIEW_END = 6`
`static final int`	`TEXT_ALIGNMENT_VIEW_START = 5`
`static final int`	`TEXT_DIRECTION_ANY_RTL = 2`
`static final int`	`TEXT_DIRECTION_FIRST_STRONG = 1`
`static final int`	`TEXT_DIRECTION_FIRST_STRONG_LTR = 6`
`static final int`	`TEXT_DIRECTION_FIRST_STRONG_RTL = 7`
`static final int`	`TEXT_DIRECTION_INHERIT = 0`
`static final int`	`TEXT_DIRECTION_LOCALE = 5`
`static final int`	`TEXT_DIRECTION_LTR = 3`
`static final int`	`TEXT_DIRECTION_RTL = 4`
`static final Property<View, Float>`	`TRANSLATION_X`
`static final Property<View, Float>`	`TRANSLATION_Y`
`static final Property<View, Float>`	`TRANSLATION_Z`
`static final String`	`VIEW_LOG_TAG = "View"`
`static final int`	`VISIBLE = 0`
`static final int[]`	`WINDOW_FOCUSED_STATE_SET`
`static final Property<View, Float>`	`X`
`static final Property<View, Float>`	`Y`
`static final Property<View, Float>`	`Z`

From android.view.ViewGroup

`static final int`	`CLIP_TO_PADDING_MASK = 34`
`static final int`	`FOCUS_AFTER_DESCENDANTS = 262144`
`static final int`	`FOCUS_BEFORE_DESCENDANTS = 131072`
`static final int`	`FOCUS_BLOCK_DESCENDANTS = 393216`
`static final int`	`LAYOUT_MODE_CLIP_BOUNDS = 0`
`static final int`	`LAYOUT_MODE_OPTICAL_BOUNDS = 1`
`static final int`	`PERSISTENT_ALL_CACHES = 3` This field is deprecated.
`static final int`	`PERSISTENT_ANIMATION_CACHE = 1` This field is deprecated.
`static final int`	`PERSISTENT_NO_CACHE = 0` This field is deprecated.
`static final int`	`PERSISTENT_SCROLLING_CACHE = 2` This field is deprecated.

Inherited methods

From android.widget.FrameLayout

`boolean`	`checkLayoutParams(ViewGroup.LayoutParams p)`
`FrameLayout.LayoutParams`	`generateDefaultLayoutParams()`
`FrameLayout.LayoutParams`	`generateLayoutParams(AttributeSet attrs)`
`CharSequence`	`getAccessibilityClassName()`
`boolean`	`getConsiderGoneChildrenWhenMeasuring()` This method is deprecated.
`boolean`	`getMeasureAllChildren()`
`void`	`onLayout(boolean changed, int left, int top, int right, int bottom)`
`void`	`onMeasure(int widthMeasureSpec, int heightMeasureSpec)`
`void`	`setForegroundGravity(int foregroundGravity)`
`void`	`setMeasureAllChildren(boolean measureAll)`
`boolean`	`shouldDelayChildPressedState()`

From androidx.leanback.widget.picker.Picker

`void`	`addOnValueChangedListener(@NonNull Picker.PickerValueListener listener)` Register a callback to be invoked when the picker's value has changed.
`boolean`	`dispatchKeyEvent(KeyEvent event)`
`float`	`getActivatedVisibleItemCount()` Returns number of visible items showing in a column when it's activated.
`@Nullable PickerColumn`	`getColumnAt(int colIndex)` Get nth PickerColumn.
`int`	`getColumnsCount()` Get number of PickerColumns.
`int`	`getPickerItemHeightPixels()` Classes extending `Picker` can choose to override this method to supply the `Picker`'s column's single item height in pixels.
`final @LayoutRes int`	`getPickerItemLayoutId()` Classes extending `Picker` can call `setPickerItemLayoutId` to supply the `Picker`'s item's layout id
`final @IdRes int`	`getPickerItemTextViewId()` Returns the `Picker`'s item's `TextView`'s id from within the layout provided by `getPickerItemLayoutId` or 0 if the layout provided by `getPickerItemLayoutId` is a {link TextView}.
`int`	`getSelectedColumn()` Get current activated column index.
`final CharSequence`	`getSeparator()` This method is deprecated. Use `getSeparators`
`final @NonNull List<CharSequence>`	`getSeparators()` Returns the list of separators that will be populated between the picker column fields.
`float`	`getVisibleItemCount()` Returns number of visible items showing in a column when it's not activated.
`boolean`	`onRequestFocusInDescendants(int direction, Rect previouslyFocusedRect)`
`void`	`removeOnValueChangedListener( @NonNull Picker.PickerValueListener listener )` Remove a previously installed value changed callback
`void`	`requestChildFocus(View child, View focused)`
`void`	`setActivated(boolean activated)`
`void`	`setActivatedVisibleItemCount(float visiblePickerItems)` Changes number of visible items showing in a column when it's activated.
`void`	`setColumnAt(int columnIndex, @NonNull PickerColumn column)` When column labels change or column range changes, call this function to re-populate the selection list.
`void`	`setColumnValue(int columnIndex, int value, boolean runAnimation)` Manually set current value of a column.
`void`	`setColumns(@NonNull List<PickerColumn> columns)` Set columns and create Views.
`final void`	`setPickerItemLayoutId(@LayoutRes int pickerItemLayoutId)` Sets the layout to use for picker items.
`final void`	`setPickerItemTextViewId(@IdRes int textViewId)` Sets the `Picker`'s item's `TextView`'s id from within the layout provided by `getPickerItemLayoutId` or 0 if the layout provided by `getPickerItemLayoutId` is a {link TextView}.
`void`	`setSelectedColumn(int columnIndex)` Change current selected column.
`final void`	`setSeparator(@NonNull CharSequence separator)` Sets separator String between Picker columns.
`final void`	`setSeparators(@NonNull List<CharSequence> separators)` Sets the list of separators that will be populated between the Picker columns.
`void`	`setVisibleItemCount(float pickerItems)` Changes number of visible items showing in a column when it's not activated.

From android.view.View

`void`	`addOnAttachStateChangeListener( View.OnAttachStateChangeListener listener )`
`void`	`addOnLayoutChangeListener(View.OnLayoutChangeListener listener)`
`void`	`addOnUnhandledKeyEventListener( View.OnUnhandledKeyEventListener listener )`
`ViewPropertyAnimator`	`animate()`
`void`	`announceForAccessibility(CharSequence text)` This method is deprecated.
`void`	`autofill(SparseArray<AutofillValue> values)`
`boolean`	`awakenScrollBars()`
`void`	`bringToFront()`
`void`	`buildDrawingCache()` This method is deprecated.
`void`	`buildLayer()`
`boolean`	`callOnClick()`
`boolean`	`canResolveLayoutDirection()`
`boolean`	`canResolveTextAlignment()`
`boolean`	`canResolveTextDirection()`
`boolean`	`canScrollHorizontally(int direction)`
`boolean`	`canScrollVertically(int direction)`
`final void`	`cancelDragAndDrop()`
`void`	`cancelLongPress()`
`final void`	`cancelPendingInputEvents()`
`boolean`	`checkInputConnectionProxy(View view)`
`void`	`clearAnimation()`
`void`	`clearPendingCredentialRequest()`
`void`	`clearViewTranslationCallback()`
`static int`	`combineMeasuredStates(int curState, int newState)`
`int`	`computeHorizontalScrollExtent()`
`int`	`computeHorizontalScrollOffset()`
`int`	`computeHorizontalScrollRange()`
`void`	`computeScroll()`
`WindowInsets`

TimePicker

Summary

Public constructors

Public methods

Inherited Constants

Inherited methods