TimePicker

java.lang.Object
- ohos.agp.components.Component
- - ohos.agp.components.ComponentContainer
  - - ohos.agp.components.StackLayout
    - - ohos.agp.components.TimePicker

所有已实现的接口:

ComponentParent
```
public class TimePicker
extends StackLayout
```
Provides a time picker.
This class can be used in countdown time selection. Either the 24-hour or 12-hour time mode can be selected.

从以下版本开始:

1

嵌套类概要

嵌套类
限定符和类型	类	说明
`static class`	`TimePicker.AmPmOrder`	Defines the display format of the column representing a.m.
`static interface`	`TimePicker.TimeChangedListener`	Provides a time change listener.

从类继承的嵌套类/接口 ohos.agp.components.Component
Component.BindStateChangedListener, Component.CanAcceptScrollListener, Component.ClickedListener, Component.ComponentStateChangedListener, Component.ContourRefreshedListener, Component.DefSpeechEventListener, Component.DoubleClickedListener, Component.DragFeedbackProvider, Component.DraggedListener, Component.DrawTask, Component.EditEventListener, Component.EstimateSizeListener, Component.EstimateSpec, Component.FadeEffectEnum, Component.FocusChangedListener, Component.ForwardHoverListener, Component.ForwardTouchListener, Component.GestureType, Component.HoverEventListener, Component.KeyEventListener, Component.LayoutDirection, Component.LayoutRefreshedListener, Component.LongClickedListener, Component.MeasureSpec, Component.MouseEventListener, Component.MousePointerStyleListener, Component.OnDragListener, Component.RotationEventListener, Component.ScaledListener, Component.ScrolledListener, Component.ShadowDevice, Component.ShadowMode, Component.ShadowSize, Component.SpeechEventListener, Component.TouchEventListener, Component.UnconsumedKeyEventListener, Component.VoiceEvent

从类继承的嵌套类/接口 ohos.agp.components.ComponentContainer
ComponentContainer.ArrangeListener

从类继承的嵌套类/接口 ohos.agp.components.StackLayout
StackLayout.LayoutConfig

字段概要

字段
限定符和类型	字段	说明
`protected TimePicker.TimeChangedListener`	`mTimeChangedListener`	Indicates the listener `TimePicker.TimeChangedListener` to listen for the change of the selected time.
`static float`	`ROTATION_SENSITIVITY_DEFAULT`	Indicates the default rotation sensitivity of `TimePicker` to respond to rotating crown events.
`static float`	`ROTATION_SENSITIVITY_HIGH`	Indicates the high rotation sensitivity of `TimePicker` to respond to rotating crown events.
`static float`	`ROTATION_SENSITIVITY_LOW`	Indicates the low rotation sensitivity of `TimePicker` to respond to rotating crown events.

从类继承的字段 ohos.agp.components.Component
ACCESSIBILITY_ADAPTABLE, ACCESSIBILITY_DISABLE, ACCESSIBILITY_ENABLE, AXIS_X, AXIS_Y, CONTOUR_BACKGROUND, CONTOUR_BORDER, CONTOUR_PADDING_BORDER, DEFAULT_SCALE, DRAG_DOWN, DRAG_HORIZONTAL, DRAG_HORIZONTAL_VERTICAL, DRAG_LEFT, DRAG_RIGHT, DRAG_UP, DRAG_VERTICAL, EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED, EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED_CLEAR, EVENT_TYPE_COMPONENT_CLICKED, EVENT_TYPE_COMPONENT_FOCUSED, EVENT_TYPE_COMPONENT_LONG_CLICKED, EVENT_TYPE_COMPONENT_SCROLLED, EVENT_TYPE_COMPONENT_SELECTED, EVENT_TYPE_COMPONENT_TEXT_UPDATE, EVENT_TYPE_NOTICE, EVENT_TYPE_NOTIFICATION_STATE_UPDATE, EVENT_TYPE_TOAST_SHOW, EVENT_TYPE_WINDOW_STATE_UPDATE, FOCUS_ADAPTABLE, FOCUS_DISABLE, FOCUS_ENABLE, FOCUS_NEXT, FOCUS_PREVIOUS, FOCUS_SIDE_BOTTOM, FOCUS_SIDE_LEFT, FOCUS_SIDE_RIGHT, FOCUS_SIDE_TOP, HIDE, HORIZONTAL, ID_DEFAULT, INHERITED_MODE, INVISIBLE, mBackgroundElement, mCanvasForTaskOverContent, mCanvasForTaskUnderContent, mComponentParent, mContext, mDrawTaskOverContent, mDrawTaskUnderContent, mEstimateSizeListener, mForegroundElement, mForwardHoverListener, mHoverEventListener, mKeyEventListener, mMouseEventListener, mPosition, mRotationEventListener, mShadowElement, mUnconsumedKeyEventListener, OVAL_MODE, OVAL_SCROLL_BAR_MODE, POSITION_X_INDEX, POSITION_Y_INDEX, RECT_MODE, RECT_SCROLL_BAR_MODE, SCROLL_AUTO_STAGE, SCROLL_IDLE_STAGE, SCROLL_NORMAL_STAGE, UNSPECIFIED_SCROLL_BAR_MODE, VERTICAL, VISIBLE

从类继承的字段 ohos.agp.components.ComponentContainer
FOCUS_CHILDREN_FIRST, FOCUS_CHILDREN_HIDE, FOCUS_PARENT_FIRST, mArrangeListener

构造器概要

构造器
构造器	说明
`TimePicker(Context context)`	Default constructor used to create a `TimePicker` instance by using the default attribute set and style.
`TimePicker(Context context, AttrSet attrSet)`	A constructor used to create a `TimePicker` instance by using specified attribute set and default style after the XML file is parsed.
`TimePicker(Context context, AttrSet attrSet, String styleName)`	A constructor used to create a `TimePicker` instance by using specified attribute set and specified style after the XML file is parsed.

方法概要

所有方法实例方法具体方法
限定符和类型	方法	说明
`void`	`enableHour(boolean enable)`	Sets whether to enable the hour selector.
`void`	`enableMinute(boolean enable)`	Sets whether to enable the minute selector.
`void`	`enableSecond(boolean enable)`	Sets whether to enable the second selector.
`TimePicker.AmPmOrder`	`getAmPmOrder()`	Obtains the format of the column representing a.m.
`String[]`	`getAmPmStrings()`	Obtains a string array indicating a.m.
`String`	`getAmString()`	Obtains the string that represents a.m.
`Element`	`getDisplayedBottomElement()`	Obtains the `Element` instance used to draw the split line at the bottom of a selected number in the time picker.
`Element[]`	`getDisplayedLinesElements()`	Obtains an array of instances used to draw split lines in this time picker.
`Element`	`getDisplayedTopElement()`	Obtains the `Element` instance of the top split line in this time picker.
`int`	`getHour()`	Obtains the selected hour.
`int`	`getMinute()`	Obtains the selected minute.
`Color`	`getNormalTextColor()`	Gets the normal font color of the time displayed in the time picker.
`Font`	`getNormalTextFont()`	Obtains the font of the normal text in this time picker.
`int`	`getNormalTextSize()`	Gets the normal font size of the time displayed in the time picker.
`Element`	`getOperatedTextBackgroundElement()`	Obtains the `Element` set as the text background of the selected item that is being operated.
`Color`	`getOperatedTextColor()`	Obtains the color of the operated text in the time picker.
`String`	`getPmString()`	Obtains the string represents p.m.
`void`	`getRange(int[] ranges)`	Obtains the time range that can be selected.
`int`	`getSecond()`	Obtains the selected second.
`float`	`getSelectedNormalTextMarginRatio()`	Obtains the ratio of the selected to normal text margin in this time picker.
`Element`	`getSelectedTextBackgroundElement()`	Obtains the `Element` set as the background of the text selected in this time picker.
`Color`	`getSelectedTextColor()`	Gets the selected font color of the time displayed in the time picker.
`Font`	`getSelectedTextFont()`	Obtains the font of the selected text in this time picker.
`int`	`getSelectedTextSize()`	Gets the selected font size of the time displayed in the time picker.
`int`	`getSelectorItemNum()`	Obtains the number of items displayed on a selector.
`Color`	`getShaderColor()`	Obtains the shader color of the time picker.
`TimePicker.TimeChangedListener`	`getTimeChangedListener()`	Obtains the callback object used to listen for time change events of this picker.
`boolean`	`is24Hour()`	Obtains whether the time is displayed in 24-hour mode.
`boolean`	`isHourEnabled()`	Obtains whether the hour selector is enabled.
`boolean`	`isHourShown()`	Obtains the state of the hour selector.
`boolean`	`isMinuteEnabled()`	Obtains whether the minute selector is enabled.
`boolean`	`isMinuteShown()`	Obtains the state of the minute selector.
`boolean`	`isSecondEnabled()`	Obtains whether the second selector is enabled.
`boolean`	`isSecondShown()`	Obtains the state of the second selector.
`boolean`	`isWheelModeEnabled()`	Obtains whether wheel mode is enabled for the selector wheel of a time picker.
`void`	`set24Hour(boolean is24Hour)`	Sets whether to display the time in 24-hour mode.
`void`	`setAmPmOrder(TimePicker.AmPmOrder order)`	Sets the format of the column representing a.m.
`void`	`setAmPmStrings(String am, String pm)`	Sets character strings that represent a.m.
`void`	`setAmString(String am)`	Sets the string that represents a.m.
`void`	`setDisplayedBottomElement(Element bottom)`	Sets the split line at the bottom of a selected number in this time picker.
`void`	`setDisplayedLinesElements(Element top, Element bottom)`	Sets a `Element` instance to draw the split line for selected text in the time picker.
`void`	`setDisplayedTopElement(Element top)`	Sets the split line on the top of a selected number in this time picker.
`void`	`setHour(int hour)`	Sets the selected hour.
`void`	`setMinute(int minute)`	Sets the selected minute.
`void`	`setNormalTextColor(Color color)`	Sets the normal font color of the time displayed in the time picker.
`void`	`setNormalTextFont(Font font)`	Sets the font for the normal text in this time picker.
`void`	`setNormalTextSize(int size)`	Sets the normal font size of the time displayed in the time picker.
`void`	`setOperatedTextBackground(Element element)`	Sets the specified `Element` as the text background of the selected item that is being operated.
`void`	`setOperatedTextColor(Color color)`	Sets the color of the operated text in the time picker.
`void`	`setPmString(String pm)`	Sets the string that represents p.m.
`void`	`setRange(int[] ranges)`	Sets the time range that can be selected.
`void`	`setSecond(int second)`	Sets the selected second.
`void`	`setSelectedNormalTextMarginRatio(float textMarginRatio)`	Sets the ratio of the selected to normal text margin in this time picker.
`void`	`setSelectedTextBackground(Element element)`	Sets the specified `Element` as the background of the selected text in this time picker.
`void`	`setSelectedTextColor(Color color)`	Sets the selected font color of the time displayed in the time picker.
`void`	`setSelectedTextFont(Font font)`	Sets the font for the selected text in this time picker.
`void`	`setSelectedTextSize(int size)`	Sets the selected font size of the time displayed in the time picker.
`void`	`setSelectorItemNum(int itemNum)`	Sets the number of items to display on a selector.
`void`	`setShaderColor(Color color)`	Sets a shader color for the time picker.
`void`	`setTimeChangedListener(TimePicker.TimeChangedListener listener)`	Sets the listener `TimePicker.TimeChangedListener` to listen for the change of the selected time.
`void`	`setWheelModeEnabled(boolean isEnabled)`	Sets whether to enable wheel mode for the selector wheel of a time picker.
`void`	`showHour(boolean show)`	Sets whether to show the hour selector.
`void`	`showMinute(boolean show)`	Sets whether to show the minute selector.
`void`	`showSecond(boolean show)`	Sets whether to show the second selector.

从类继承的方法 ohos.agp.components.Component
addDrawTask, addDrawTask, addScrolledListener, announceAccessibility, arrange, bindCornerMark, callOnClick, canScroll, clearFocus, createAnimatorProperty, disableFadeEffect, draw, enableCornerMark, enableFadeEffect, enableSaveState, enableScrollBar, estimateSize, executeDoubleClick, executeLongClick, findFocus, findNextFocusableComponent, findRequestNextFocus, getAccessibility, getAccessibilityDescription, getAlpha, getAltitude, getBackgroundElement, getBaseLine, getBottom, getBoundaryFadeEffectBottomRate, getBoundaryFadeEffectLeftRate, getBoundaryFadeEffectRightRate, getBoundaryFadeEffectTopRate, getCenterZoomFactor, getCentralScrollMode, getClickedListener, getClipEnabled, getComponentDescription, getComponentMinSize, getComponentParent, getComponentPosition, getComponentSize, getComponentStateChangedListener, getComponentTreeObserver, getContentEnable, getContentPosition, getContentPositionX, getContentPositionY, getContext, getContour, getContourRefreshedListener, getCornerMark, getDragAcceptAngle, getDraggedListener, getEditEventListener, getEstimatedHeight, getEstimatedWidth, getFadeEffectBoundaryWidth, getFadeEffectColor, getFocusable, getFocusBorderEnable, getFocusBorderPadding, getFocusBorderRadius, getFocusBorderWidth, getForegroundElement, getForegroundGravity, getForwardHoverListener, getForwardTouchListener, getGesturePriority, getHeight, getHorizontalPadding, getHorizontalPosition, getHoverEventListener, getId, getKeyEventListener, getLayoutConfig, getLayoutDirection, getLayoutDirectionResolved, getLayoutRefreshedListener, getLeft, getLocationOnScreen, getMarginBottom, getMarginLeft, getMarginRight, getMargins, getMarginsLeftAndRight, getMarginsTopAndBottom, getMarginTop, getMatrix, getMinHeight, getMinWidth, getMode, getModeResolved, getMouseEventListener, getMousePointerStyleListener, getName, getPadding, getPaddingBottom, getPaddingEnd, getPaddingLeft, getPaddingRight, getPaddingStart, getPaddingTop, getPivot, getPivotX, getPivotY, getResourceManager, getRight, getRotation, getRotationEventListener, getRotationSensitivity, getScale, getScaledListener, getScaleX, getScaleY, getScrollbarBackgroundColor, getScrollbarColor, getScrollbarFadingDelay, getScrollbarFadingDuration, getScrollBarMode, getScrollbarRadius, getScrollbarRoundRect, getScrollbarStartAngle, getScrollbarSweepAngle, getScrollbarThickness, getScrollState, getScrollValue, getSelfVisibleRect, getShadowColor, getSpeechEventListener, getTag, getTop, getTouchEventListener, getTransitionSymbol, getTranslation, getTranslationX, getTranslationY, getTranslationZ, getUserNextFocus, getVerticalPadding, getVerticalPosition, getVisibility, getVisibleRectOnScreen, getWidth, getWindowVisibleRect, hasFocus, hasFocusedEffect, hasOverlaps, hideFocusBorder, invalidate, isBoundaryFadeEffectEnable, isBoundToWindow, isClickable, isClipToContourEnabled, isComponentDisplayed, isEnabled, isFadeEffected, isFocusable, isFocused, isIdentityMatrix, isLongClickOn, isPressed, isRtl, isSaveStateEnabled, isScrollbarFadingOn, isScrollBarOn, isScrollbarOverlapEnabled, isSelected, isSoundEnable, isTouchFocusable, isVibrationEffectEnabled, notifyAccessibility, onAttributeConfigChanged, onRestoreState, onRtlChanged, onSaveState, performScale, playSound, postLayout, refreshContour, release, removeBindStateChangedListener, removeScrolledListener, requestFocus, requestForceForwardTouchEvent, restoreComponentTreeState, saveComponentTreeState, scrollBy, scrollTo, setAccessibility, setAccessibilityDescription, setAlpha, setAltitude, setBackground, setBindStateChangedListener, setBottom, setBoundaryFadeEffectEnable, setCanAcceptScrollListener, setCenterZoomFactor, setCentralScrollMode, setClickable, setClickedListener, setClipEnabled, setClipToContourEnabled, setComponentDescription, setComponentMinSize, setComponentPosition, setComponentPosition, setComponentSize, setComponentStateChangedListener, setContentEnable, setContentPosition, setContentPositionX, setContentPositionY, setContour, setContourRefreshedListener, setDoubleClickedListener, setDragAcceptAngle, setDraggedListener, setEditEventListener, setEnabled, setEstimatedSize, setEstimateSizeListener, setFadeEffectBoundaryWidth, setFadeEffectColor, setFocusable, setFocusBorderEnable, setFocusBorderPadding, setFocusBorderRadius, setFocusBorderRadius, setFocusBorderWidth, setFocusChangedListener, setFocusedEffect, setForeground, setForegroundGravity, setForwardHoverListener, setForwardTouchListener, setGesturePriority, setHeight, setHorizontalPadding, setHorizontalPosition, setHoverEventListener, setId, setKeyEventListener, setLayoutConfig, setLayoutDirection, setLayoutRefreshedListener, setLeft, setLongClickable, setLongClickedListener, setMarginBottom, setMarginLeft, setMarginRight, setMarginsLeftAndRight, setMarginsTopAndBottom, setMarginTop, setMinHeight, setMinWidth, setMode, setMouseEventListener, setMousePointerStyleListener, setName, setOnDragListener, setPadding, setPaddingBottom, setPaddingLeft, setPaddingRelative, setPaddingRight, setPaddingTop, setPivot, setPivot, setPivotX, setPivotY, setPosition, setPositionX, setPositionY, setPressState, setRight, setRotation, setRotationEventListener, setRotationSensitivity, setScale, setScaledListener, setScaleX, setScaleY, setScrollbarBackgroundColor, setScrollbarColor, setScrollbarFadingDelay, setScrollbarFadingDuration, setScrollbarFadingEnabled, setScrollBarMode, setScrollbarOverlapEnabled, setScrollbarRadius, setScrollbarRoundRect, setScrollbarStartAngle, setScrollbarSweepAngle, setScrollbarThickness, setScrolledListener, setSelected, setShadowColor, setShadowStyle, setSoundEnable, setSpeechEventListener, setTag, setTop, setTouchEventListener, setTouchFocusable, setTransitionSymbol, setTranslation, setTranslationX, setTranslationY, setTranslationZ, setUnconsumedKeyEventListener, setUserNextFocus, setVerticalPadding, setVerticalPosition, setVibrationEffectEnabled, setVisibility, setWidth, showFocusBorder, simulateClick, simulateDrag, startDragAndDrop, subscribeVoiceEvents, unsubscribeVoiceEvents

从接口继承的方法 ohos.agp.components.ComponentParent
getComponentParent, postLayout

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从类继承的方法 ohos.agp.components.StackLayout
createLayoutConfig, verifyLayoutConfig

- 字段详细资料
  - ROTATION_SENSITIVITY_DEFAULT
```
public static final float ROTATION_SENSITIVITY_DEFAULT
```
    Indicates the default rotation sensitivity of TimePicker to respond to rotating crown events. You can use Component.setRotationSensitivity(float) to set.
    
    另请参阅:
    
    常量字段值
  - ROTATION_SENSITIVITY_HIGH
```
public static final float ROTATION_SENSITIVITY_HIGH
```
    Indicates the high rotation sensitivity of TimePicker to respond to rotating crown events. You can use Component.setRotationSensitivity(float) to set.
    
    另请参阅:
    
    常量字段值
  - ROTATION_SENSITIVITY_LOW
```
public static final float ROTATION_SENSITIVITY_LOW
```
    Indicates the low rotation sensitivity of TimePicker to respond to rotating crown events. You can use Component.setRotationSensitivity(float) to set.
    
    另请参阅:
    
    常量字段值
  - mTimeChangedListener
```
protected TimePicker.TimeChangedListener mTimeChangedListener
```
    Indicates the listener TimePicker.TimeChangedListener to listen for the change of the selected time.
- 构造器详细资料
  - TimePicker
```
public TimePicker(Context context)
```
    Default constructor used to create a TimePicker instance by using the default attribute set and style.
    
    参数:
    
    context - Indicates the application context.
  - TimePicker
```
public TimePicker(Context context,
                  AttrSet attrSet)
```
    A constructor used to create a TimePicker instance by using specified attribute set and default style after the XML file is parsed.
    
    参数:
    
    context - Indicates the application context.
    
    attrSet - Indicates the attribute set to be used.
  - TimePicker
```
public TimePicker(Context context,
                  AttrSet attrSet,
                  String styleName)
```
    A constructor used to create a TimePicker instance by using specified attribute set and specified style after the XML file is parsed.
    
    参数:
    
    context - Indicates the application context.
    
    attrSet - Indicates the attribute set to be used.
    
    styleName - Indicates the style name to use.
- 方法详细资料
  - isHourEnabled
```
public boolean isHourEnabled()
```
    Obtains whether the hour selector is enabled.
    
    返回:
    
    Returns true if the hour selector is enabled; returns false otherwise.
  - enableHour
```
public void enableHour(boolean enable)
```
    Sets whether to enable the hour selector.
    
    参数:
    
    enable - Specifies whether to enable the hour selector. The value true indicates that the hour selector is enabled, and the value false indicates that the hour selector is disabled.
  - showHour
```
public void showHour(boolean show)
```
    Sets whether to show the hour selector.
    
    参数:
    
    show - Specifies whether to show the hour selector. The value true indicates that the hour selector is shown, and the value false indicates that the hour selector is hidden.
  - isHourShown
```
public boolean isHourShown()
```
    Obtains the state of the hour selector.
    
    返回:
    
    Returns true if the hour selector is shown; returns false otherwise.
  - isMinuteEnabled
```
public boolean isMinuteEnabled()
```
    Obtains whether the minute selector is enabled.
    
    返回:
    
    Returns true if the minute selector is enabled; returns false otherwise.
  - enableMinute
```
public void enableMinute(boolean enable)
```
    Sets whether to enable the minute selector.
    
    参数:
    
    enable - Specifies whether to enable the minute selector. The value true indicates that the minute selector is enabled, and the value false indicates that the minute selector is disabled.
  - showMinute
```
public void showMinute(boolean show)
```
    Sets whether to show the minute selector.
    
    参数:
    
    show - Specifies whether to show the minute selector. The value true indicates that the minute selector is shown, and the value false indicates that the minute selector is hidden.
  - isMinuteShown
```
public boolean isMinuteShown()
```
    Obtains the state of the minute selector.
    
    返回:
    
    Returns true if the minute selector is shown; returns false otherwise.
  - isSecondEnabled
```
public boolean isSecondEnabled()
```
    Obtains whether the second selector is enabled.
    
    返回:
    
    Returns true if the second selector is enabled; returns false otherwise.
  - enableSecond
```
public void enableSecond(boolean enable)
```
    Sets whether to enable the second selector.
    
    参数:
    
    enable - Specifies whether to enable the second selector. The value true indicates that the second selector is enabled, and the value false indicates that the second selector is disabled.
  - showSecond
```
public void showSecond(boolean show)
```
    Sets whether to show the second selector.
    
    参数:
    
    show - Specifies whether to show the second selector. The value true indicates that the second selector is shown, and the value false indicates that the second selector is hidden.
  - isSecondShown
```
public boolean isSecondShown()
```
    Obtains the state of the second selector.
    
    返回:
    
    Returns true if the second selector is shown; returns false otherwise.
  - getHour
```
public int getHour()
```
    Obtains the selected hour.
    
    返回:
    
    Returns the selected hour.
  - setHour
```
public void setHour(int hour)
```
    Sets the selected hour.
    
    参数:
    
    hour - Indicates the selected hour.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if hour parameter is less than 0 or bigger than 23.
  - getMinute
```
public int getMinute()
```
    Obtains the selected minute.
    
    返回:
    
    Returns the selected minute.
  - setMinute
```
public void setMinute(int minute)
```
    Sets the selected minute.
    
    参数:
    
    minute - Indicates the selected minute.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if minute parameter is less than 0 or bigger than 59.
  - getSecond
```
public int getSecond()
```
    Obtains the selected second.
    
    返回:
    
    Returns the selected second.
  - setSecond
```
public void setSecond(int second)
```
    Sets the selected second.
    
    参数:
    
    second - Indicates the selected second.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if second parameter is less than 0 or bigger than 59.
  - set24Hour
```
public void set24Hour(boolean is24Hour)
```
    Sets whether to display the time in 24-hour mode.
    
    参数:
    
    is24Hour - Specifies whether the time is displayed in 24-hour mode. The value true indicates that the time is displayed in 24-hour mode, and the value false indicates that the time is not displayed in the 24-hour mode.
  - is24Hour
```
public boolean is24Hour()
```
    Obtains whether the time is displayed in 24-hour mode.
    
    返回:
    
    Returns true if the time is displayed in 24-hour mode; returns false otherwise. The default value is true.
  - setTimeChangedListener
```
public void setTimeChangedListener(TimePicker.TimeChangedListener listener)
```
    Sets the listener TimePicker.TimeChangedListener to listen for the change of the selected time.
    
    参数:
    
    listener - Indicates the listener to listen for the change of the selected time.
  - setRange
```
public void setRange(int[] ranges)
```
    Sets the time range that can be selected. The time range is arranged in the array in the following sequence: start hour, start minute, start second, end hour, end minute, and end second.
    
    参数:
    
    ranges - Indicates the time range that can be selected.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the input parameter is invalid: if ranges is null or if ranges.length is not equal to 6 or if ranges[0] "starting hour" is less than 0 or bigger than 23 or if ranges[1] "starting minute" is less than 0 or bigger than 59 or if ranges[2] "starting second" is less than 0 or bigger than 59 or if ranges[3] "ending hour" is less than 0 or bigger than 23 or if ranges[4] "ending minute" is less than 0 or bigger than 59 or if ranges[5] "ending second" is less than 0 or bigger than 59.
  - getRange
```
public void getRange(int[] ranges)
```
    Obtains the time range that can be selected. The time range comes from the value assigned to the input array and is returned in the following sequence: start hour, start minute, start second, end hour, end minute, and end second.
    
    参数:
    
    ranges - Indicates the time range that can be selected.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the input parameter is invalid.
  - setNormalTextSize
```
public void setNormalTextSize(int size)
```
    Sets the normal font size of the time displayed in the time picker.
    
    参数:
    
    size - Indicates the normal font size of the time displayed in the time picker.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the input parameter is invalid.
    
    从以下版本开始:
    
    2
    
    另请参阅:
    
    getNormalTextSize(), setSelectedTextSize(int), getSelectedTextSize()
  - getNormalTextSize
```
public int getNormalTextSize()
```
    Gets the normal font size of the time displayed in the time picker.
    
    返回:
    
    The normal font size of the time displayed in the time picker.
    
    从以下版本开始:
    
    2
    
    另请参阅:
    
    setNormalTextSize(int), setSelectedTextSize(int), getSelectedTextSize()
  - setSelectedTextSize
```
public void setSelectedTextSize(int size)
```
    Sets the selected font size of the time displayed in the time picker.
    
    参数:
    
    size - Indicates the selected font size of the time displayed in the time picker.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the input parameter is invalid.
    
    从以下版本开始:
    
    2
    
    另请参阅:
    
    setNormalTextSize(int), getNormalTextSize(), getSelectedTextSize()
  - getSelectedTextSize
```
public int getSelectedTextSize()
```
    Gets the selected font size of the time displayed in the time picker.
    
    返回:
    
    The selected font size of the time displayed in the time picker.
    
    从以下版本开始:
    
    2
    
    另请参阅:
    
    setNormalTextSize(int), getNormalTextSize(), setSelectedTextSize(int)
  - setNormalTextColor
```
public void setNormalTextColor(Color color)
```
    Sets the normal font color of the time displayed in the time picker.
    
    参数:
    
    color - Indicates the normal font color of the time displayed in the time picker.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if color parameter is null.
    
    从以下版本开始:
    
    2
    
    另请参阅:
    
    getNormalTextColor(), setSelectedTextColor(Color), getSelectedTextColor(), setOperatedTextColor(Color), getOperatedTextColor()
  - getNormalTextColor
```
public Color getNormalTextColor()
```
    Gets the normal font color of the time displayed in the time picker.
    
    返回:
    
    The normal font color of the time displayed in the time picker.
    
    从以下版本开始:
    
    2
    
    另请参阅:
    
    setNormalTextColor(Color), setSelectedTextColor(Color), getSelectedTextColor(), setOperatedTextColor(Color), getOperatedTextColor()
  - setSelectedTextColor
```
public void setSelectedTextColor(Color color)
```
    Sets the selected font color of the time displayed in the time picker.
    
    参数:
    
    color - Indicates the selected font color of the time displayed in the time picker.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if color parameter is null.
    
    从以下版本开始:
    
    2
    
    另请参阅:
    
    setNormalTextColor(Color), getNormalTextColor(), getSelectedTextColor(), setOperatedTextColor(Color), getOperatedTextColor()
  - getSelectedTextColor
```
public Color getSelectedTextColor()
```
    Gets the selected font color of the time displayed in the time picker.
    
    返回:
    
    The selected font color of the time displayed in the time picker.
    
    从以下版本开始:
    
    2
    
    另请参阅:
    
    setNormalTextColor(Color), getNormalTextColor(), setSelectedTextColor(Color), setOperatedTextColor(Color), getOperatedTextColor()
  - setOperatedTextColor
```
public void setOperatedTextColor(Color color)
```
    Sets the color of the operated text in the time picker.
    
    参数:
    
    color - Indicates the color to set.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if color parameter is null.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setNormalTextColor(Color), getNormalTextColor(), setSelectedTextColor(Color), getSelectedTextColor(), getOperatedTextColor()
  - getOperatedTextColor
```
public Color getOperatedTextColor()
```
    Obtains the color of the operated text in the time picker.
    
    返回:
    
    Returns the color of the operated text.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setNormalTextColor(Color), getNormalTextColor(), setSelectedTextColor(Color), getSelectedTextColor(), setOperatedTextColor(Color)
  - setNormalTextFont
```
public void setNormalTextFont(Font font)
```
    Sets the font for the normal text in this time picker.
    
    参数:
    
    font - Indicates the font to set. For details about available values, see Font.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if font parameter is null.
    
    从以下版本开始:
    
    4
  - getNormalTextFont
```
public Font getNormalTextFont()
```
    Obtains the font of the normal text in this time picker.
    
    返回:
    
    Returns the font of the normal text.
    
    从以下版本开始:
    
    4
  - setSelectedTextFont
```
public void setSelectedTextFont(Font font)
```
    Sets the font for the selected text in this time picker.
    
    参数:
    
    font - Indicates the font to set. For details about available values, see Font.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if font parameter is null.
    
    从以下版本开始:
    
    4
  - getSelectedTextFont
```
public Font getSelectedTextFont()
```
    Obtains the font of the selected text in this time picker.
    
    返回:
    
    Returns the font of the selected text.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setSelectedTextFont(Font)
  - setSelectedTextBackground
```
public void setSelectedTextBackground(Element element)
```
    Sets the specified Element as the background of the selected text in this time picker.
    
    参数:
    
    element - Indicates the element to set.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    getSelectedTextBackgroundElement(), setOperatedTextBackground(Element), getOperatedTextBackgroundElement()
  - getSelectedTextBackgroundElement
```
public Element getSelectedTextBackgroundElement()
```
    Obtains the Element set as the background of the text selected in this time picker.
    
    返回:
    
    Returns the Element.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setSelectedTextBackground(Element), setOperatedTextBackground(Element), getOperatedTextBackgroundElement()
  - setOperatedTextBackground
```
public void setOperatedTextBackground(Element element)
```
    Sets the specified Element as the text background of the selected item that is being operated.
    
    参数:
    
    element - Indicates the element to set.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setSelectedTextBackground(Element), getSelectedTextBackgroundElement(), getOperatedTextBackgroundElement()
  - getOperatedTextBackgroundElement
```
public Element getOperatedTextBackgroundElement()
```
    Obtains the Element set as the text background of the selected item that is being operated.
    
    返回:
    
    Returns the Element.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setSelectedTextBackground(Element), getSelectedTextBackgroundElement(), setOperatedTextBackground(Element)
  - setSelectedNormalTextMarginRatio
```
public void setSelectedNormalTextMarginRatio(float textMarginRatio)
```
    Sets the ratio of the selected to normal text margin in this time picker.
    
    参数:
    
    textMarginRatio - Indicates the ratio to set. The value must be greater than or equal to 0.0f. The default value is 1.0f.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if textMarginRatio parameter is less than 0.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    getSelectedNormalTextMarginRatio()
  - getSelectedNormalTextMarginRatio
```
public float getSelectedNormalTextMarginRatio()
```
    Obtains the ratio of the selected to normal text margin in this time picker.
    
    返回:
    
    Returns the ratio.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setSelectedNormalTextMarginRatio(float)
  - setDisplayedLinesElements
```
public void setDisplayedLinesElements(Element top,
                                      Element bottom)
```
    Sets a Element instance to draw the split line for selected text in the time picker.
    
    参数:
    
    top - Indicates the Element instance to draw the split line on the top of the selected text.
    
    bottom - Indicates the Element instance to draw the split line at the bottom of the selected text.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    getDisplayedTopElement(), getDisplayedBottomElement()
  - getDisplayedTopElement
```
public Element getDisplayedTopElement()
```
    Obtains the Element instance of the top split line in this time picker.
    
    返回:
    
    Returns the Element instance.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setDisplayedLinesElements(Element, Element)
  - getDisplayedBottomElement
```
public Element getDisplayedBottomElement()
```
    Obtains the Element instance used to draw the split line at the bottom of a selected number in the time picker.
    
    返回:
    
    Returns the Element instance used to draw the split line at the bottom of the selected number.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setDisplayedLinesElements(Element, Element)
  - getDisplayedLinesElements
```
public Element[] getDisplayedLinesElements()
```
    Obtains an array of instances used to draw split lines in this time picker.
    
    返回:
    
    Returns the array of Element instances used to draw split lines.
    
    从以下版本开始:
    
    4
  - setDisplayedTopElement
```
public void setDisplayedTopElement(Element top)
```
    Sets the split line on the top of a selected number in this time picker.
    
    参数:
    
    top - Indicates the top split line to set.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    getDisplayedTopElement()
  - setDisplayedBottomElement
```
public void setDisplayedBottomElement(Element bottom)
```
    Sets the split line at the bottom of a selected number in this time picker.
    
    参数:
    
    bottom - Indicates the bottom split line to set.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    getDisplayedBottomElement()
  - setAmPmStrings
```
public void setAmPmStrings(String am,
                           String pm)
```
    Sets character strings that represent a.m. and p.m..
    
    参数:
    
    am - Indicates the character string representing a.m..
    
    pm - Indicates the character string representing p.m..
    
    从以下版本开始:
    
    2
  - setAmString
```
public void setAmString(String am)
```
    Sets the string that represents a.m.
    
    参数:
    
    am - Indicates the string representing a.m.
    
    从以下版本开始:
    
    4
  - setPmString
```
public void setPmString(String pm)
```
    Sets the string that represents p.m.
    
    参数:
    
    pm - Indicates the string representing p.m.
    
    从以下版本开始:
    
    4
  - getAmPmStrings
```
public String[] getAmPmStrings()
```
    Obtains a string array indicating a.m. and p.m..
    
    返回:
    
    Returns the string array indicating a.m. and p.m..
    
    从以下版本开始:
    
    2
  - getAmString
```
public String getAmString()
```
    Obtains the string that represents a.m.
    
    返回:
    
    Returns the string representing a.m.
    
    从以下版本开始:
    
    4
  - getPmString
```
public String getPmString()
```
    Obtains the string represents p.m.
    
    返回:
    
    Returns the string representing p.m.
    
    从以下版本开始:
    
    4
  - getTimeChangedListener
```
public TimePicker.TimeChangedListener getTimeChangedListener()
```
    Obtains the callback object used to listen for time change events of this picker.
    
    返回:
    
    Returns the callback object.
    
    从以下版本开始:
    
    4
  - setWheelModeEnabled
```
public void setWheelModeEnabled(boolean isEnabled)
```
    Sets whether to enable wheel mode for the selector wheel of a time picker. If it is enabled, the maximum value wraps around the minimum value.
    
    参数:
    
    isEnabled - Indicates whether to enable wheel mode. true indicates to enable the wheel mode; false indicates otherwise.
    
    从以下版本开始:
    
    4
  - isWheelModeEnabled
```
public boolean isWheelModeEnabled()
```
    Obtains whether wheel mode is enabled for the selector wheel of a time picker.
    
    返回:
    
    Returns true if wheel mode is enabled; returns false otherwise.
    
    从以下版本开始:
    
    4
  - setShaderColor
```
public void setShaderColor(Color color)
```
    Sets a shader color for the time picker.
    
    参数:
    
    color - Indicates the shader color.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if color parameter is null.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    getShaderColor()
  - getShaderColor
```
public Color getShaderColor()
```
    Obtains the shader color of the time picker.
    
    返回:
    
    Returns the shader color of the time picker.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setShaderColor(Color)
  - setSelectorItemNum
```
public void setSelectorItemNum(int itemNum)
```
    Sets the number of items to display on a selector.
    
    参数:
    
    itemNum - Indicates the number of items to display on the selector. The value must be greater than 0.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the number of items to display on the selector is less than or equal to 0.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    getSelectorItemNum()
  - getSelectorItemNum
```
public int getSelectorItemNum()
```
    Obtains the number of items displayed on a selector.
    
    返回:
    
    Returns the number of items displayed on the selector; returns the default value 0 if the number is not specified.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setSelectorItemNum(int)
  - setAmPmOrder
```
public void setAmPmOrder(TimePicker.AmPmOrder order)
```
    Sets the format of the column representing a.m. and p.m. in the time picker.
    The column representing a.m. and p.m. can be displayed at the start or in the end of the picker by specifying the value AmPmOrder#START or AmPmOrder#END. The direction (left-to-right or right-to-left) of AmPmOrder#START and AmPmOrder#END depends on specified Component.isRtl() value. The column can also be displayed on the left or right of the time picker by specifying AmPmOrder#LEFT or AmPmOrder#RIGHT.
    
    参数:
    
    order - Indicates the AmPmOrder enumeration value, which can be AmPmOrder#START, AmPmOrder#END, AmPmOrder#LEFT, or AmPmOrder#RIGHT.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if order parameter is null.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    TimePicker.AmPmOrder, getAmPmOrder(), set24Hour(boolean), setAmPmStrings(String, String)
  - getAmPmOrder
```
public TimePicker.AmPmOrder getAmPmOrder()
```
    Obtains the format of the column representing a.m. and p.m in the time picker.
    The column representing a.m. and p.m. can be displayed at the start or in the end of the picker by specifying the value AmPmOrder#START or AmPmOrder#END.The direction (left-to-right or right-to-left) of AmPmOrder#START and AmPmOrder#END depends on the specified Component.isRtl() value.
    
    返回:
    
    Returns the AmPmOrder enumeration value, which can be AmPmOrder#START, AmPmOrder#END, AmPmOrder#LEFT, or AmPmOrder#RIGHT.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    TimePicker.AmPmOrder, setAmPmOrder(AmPmOrder), set24Hour(boolean), setAmPmStrings(String, String)

类 TimePicker

嵌套类概要

从类继承的嵌套类/接口 ohos.agp.components.Component

从类继承的嵌套类/接口 ohos.agp.components.ComponentContainer

从类继承的嵌套类/接口 ohos.agp.components.StackLayout

字段概要

从类继承的字段 ohos.agp.components.Component

从类继承的字段 ohos.agp.components.ComponentContainer

构造器概要

方法概要

从类继承的方法 ohos.agp.components.Component

从类继承的方法 ohos.agp.components.ComponentContainer

从接口继承的方法 ohos.agp.components.ComponentParent

从类继承的方法 java.lang.Object

从类继承的方法 ohos.agp.components.StackLayout

字段详细资料

ROTATION_SENSITIVITY_DEFAULT

ROTATION_SENSITIVITY_HIGH

ROTATION_SENSITIVITY_LOW

mTimeChangedListener

构造器详细资料

TimePicker

TimePicker

TimePicker

方法详细资料

isHourEnabled

enableHour

showHour

isHourShown

isMinuteEnabled

enableMinute

showMinute

isMinuteShown

isSecondEnabled

enableSecond

showSecond

isSecondShown

getHour

setHour

getMinute

setMinute

getSecond

setSecond

set24Hour

is24Hour

setTimeChangedListener

setRange

getRange

setNormalTextSize

getNormalTextSize

setSelectedTextSize

getSelectedTextSize

setNormalTextColor

getNormalTextColor

setSelectedTextColor

getSelectedTextColor

setOperatedTextColor

getOperatedTextColor

setNormalTextFont

getNormalTextFont

setSelectedTextFont

getSelectedTextFont

setSelectedTextBackground

getSelectedTextBackgroundElement

setOperatedTextBackground

getOperatedTextBackgroundElement

setSelectedNormalTextMarginRatio

getSelectedNormalTextMarginRatio

setDisplayedLinesElements

getDisplayedTopElement

getDisplayedBottomElement

getDisplayedLinesElements

setDisplayedTopElement

setDisplayedBottomElement

setAmPmStrings

setAmString

setPmString

getAmPmStrings

getAmString

getPmString