鸿蒙OS TimePicker

TimePicker

java.lang.Object

|---ohos.agp.components.Component

|---|---ohos.agp.components.ComponentContainer

|---|---|---ohos.agp.components.StackLayout

|---|---|---|---ohos.agp.components.TimePicker

public class TimePicker
extends StackLayout

提供时间选择器。

该类可用于倒计时时间选择。 可选择 24 小时或 12 小时时间模式。

Since:

1

嵌套类摘要

修饰符和类型	类	描述
static class	TimePicker.AmPmOrder	定义表示上午的列的显示格式。
static interface	TimePicker.TimeChangedListener	提供时间变化监听器。

从类 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	指示监听器 TimePicker.TimeChangedListener 监听所选时间的变化。
static float	ROTATION_SENSITIVITY_DEFAULT	指示 TimePicker 响应旋转表冠事件的默认旋转灵敏度。
static float	ROTATION_SENSITIVITY_HIGH	表示 TimePicker 响应旋转表冠事件的高旋转灵敏度。
static float	ROTATION_SENSITIVITY_LOW	指示 TimePicker 响应旋转表冠事件的低旋转灵敏度。

从类 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)	用于使用默认属性集和样式创建 TimePicker 实例的默认构造函数。
TimePicker(Context context, AttrSet attrSet)	用于在 XML 文件解析后使用指定的属性集和默认样式创建 TimePicker 实例的构造函数。
TimePicker(Context context, AttrSet attrSet, String styleName)	用于在 XML 文件解析后使用指定的属性集和指定的样式创建 TimePicker 实例的构造函数。

方法总结

修饰符和类型	方法	描述
void	enableHour(boolean enable)	设置是否启用小时选择器。
void	enableMinute(boolean enable)	设置是否启用分钟选择器。
void	enableSecond(boolean enable)	设置是否启用第二个选择器。
TimePicker.AmPmOrder	getAmPmOrder()	获取表示上午的列的格式。
String[]	getAmPmStrings()	获取表示上午的字符串数组。
String	getAmString()	获取代表 a.m 的字符串。
Element	getDisplayedBottomElement()	获取用于在时间选择器中选定数字的底部绘制分割线的 Element 实例。
Element[]	getDisplayedLinesElements()	获取用于在此时间选择器中绘制分割线的实例数组。
Element	getDisplayedTopElement()	获取此时间选择器中顶部分割线的 Element 实例。
int	getHour()	获取选定的小时。
int	getMinute()	获取选定的分钟。
Color	getNormalTextColor()	获取时间选择器中显示的时间的正常字体颜色。
Font	getNormalTextFont()	获取此时间选择器中普通文本的字体。
int	getNormalTextSize()	获取时间选择器中显示的时间的正常字体大小。
Element	getOperatedTextBackgroundElement()	获取元素集作为正在操作的选中项的文本背景。
Color	getOperatedTextColor()	获取时间选择器中被操作文本的颜色。
String	getPmString()	获取代表 p.m 的字符串。
void	getRange(int[] ranges)	获取可选择的时间范围。
int	getSecond()	获得选定的秒数。
float	getSelectedNormalTextMarginRatio()	获取此时间选择器中选定文本与正常文本边距的比率。
Element	getSelectedTextBackgroundElement()	获取元素集作为在此时间选择器中选择的文本的背景。
Color	getSelectedTextColor()	获取时间选择器中显示的时间的选定字体颜色。
Font	getSelectedTextFont()	获取此时间选择器中选定文本的字体。
int	getSelectedTextSize()	获取时间选择器中显示的时间的选定字体大小。
int	getSelectorItemNum()	获取选择器上显示的项目数。
Color	getShaderColor()	获取时间选择器的着色器颜色。
TimePicker.TimeChangedListener	getTimeChangedListener()	获取用于监听该picker时间变化事件的回调对象。
boolean	is24Hour()	获取时间是否以 24 小时制显示。
boolean	isHourEnabled()	获取是否启用小时选择器。
boolean	isHourShown()	获取小时选择器的状态。
boolean	isMinuteEnabled()	获取分钟选择器是否启用。
boolean	isMinuteShown()	获取分钟选择器的状态。
boolean	isSecondEnabled()	获取是否启用了第二个选择器。
boolean	isSecondShown()	获取第二个选择器的状态。
boolean	isWheelModeEnabled()	获取时间选择器的选择轮是否启用轮模式。
void	set24Hour(boolean is24Hour)	设置是否以 24 小时制显示时间。
void	setAmPmOrder(TimePicker.AmPmOrder order)	设置表示上午的列的格式。
void	setAmPmStrings(String am, String pm)	设置代表上午的字符串。
void	setAmString(String am)	设置代表上午的字符串。
void	setDisplayedBottomElement(Element bottom)	将分割线设置在此时间选择器中选定数字的底部。
void	setDisplayedLinesElements(Element top, Element bottom)	设置一个 Element 实例以在时间选择器中为选定文本绘制分割线。
void	setDisplayedTopElement(Element top)	在此时间选择器中设置所选数字顶部的分割线。
void	setHour(int hour)	设置选定的小时。
void	setMinute(int minute)	设置选定的分钟。
void	setNormalTextColor(Color color)	设置时间选择器中显示的时间的正常字体颜色。
void	setNormalTextFont(Font font)	设置此时间选择器中普通文本的字体。
void	setNormalTextSize(int size)	设置时间选择器中显示的时间的正常字体大小。
void	setOperatedTextBackground(Element element)	将指定的 Element 设置为正在操作的选中项的文本背景。
void	setOperatedTextColor(Color color)	设置时间选择器中操作文本的颜色。
void	setPmString(String pm)	设置代表下午的字符串。
void	setRange(int[] ranges)	设置可选择的时间范围。
void	setSecond(int second)	设置选定的秒数。
void	setSelectedNormalTextMarginRatio(float textMarginRatio)	在此时间选择器中设置所选文本边距与正常文本边距的比率。
void	setSelectedTextBackground(Element element)	将指定的 Element 设置为此时间选择器中选定文本的背景。
void	setSelectedTextColor(Color color)	设置时间选择器中显示的时间的选定字体颜色。
void	setSelectedTextFont(Font font)	设置此时间选择器中选定文本的字体。
void	setSelectedTextSize(int size)	设置时间选择器中显示的时间的选定字体大小。
void	setSelectorItemNum(int itemNum)	设置要在选择器上显示的项目数。
void	setShaderColor(Color color)	为时间选择器设置着色器颜色。
void	setTimeChangedListener(TimePicker.TimeChangedListener listener)	设置侦听器 TimePicker.TimeChangedListener 以侦听所选时间的变化。
void	setWheelModeEnabled(boolean isEnabled)	设置是否为时间选择器的选择轮启用轮模式。
void	showHour(boolean show)	设置是否显示小时选择器。
void	showMinute(boolean show)	设置是否显示分钟选择器。
void	showSecond(boolean show)	设置是否显示第二个选择器。

从类 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.ComponentContainer 继承的方法

addComponent, addComponent, addComponent, addComponent, addComponent, dispatchRestoreState, dispatchSaveState, findComponentById, findComponentHolderById, getAutoLayout, getChildCount, getChildIndex, getComponentAt, getComponentTransition, getFocusOrder, getLayoutManager, informConfigurationChanged, isClipToChildBoundsEnabled, isClipToPaddingBoundsEnabled, isTouchEventSplitable, moveChildToFront, onDrag, removeAllComponents, removeComponent, removeComponentAt, removeComponentById, removeComponents, setArrangeListener, setAutoLayout, setAutoLayout, setClipToChildBoundsEnabled, setClipToPaddingBoundsEnabled, setComponentTransition, setFocusOrder, setLayoutManager, setTouchEventSplitable

从接口 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

指示 TimePicker 响应旋转表冠事件的默认旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。

ROTATION_SENSITIVITY_HIGH

public static final float ROTATION_SENSITIVITY_HIGH

表示 TimePicker 响应旋转表冠事件的高旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。

ROTATION_SENSITIVITY_LOW

public static final float ROTATION_SENSITIVITY_LOW

指示 TimePicker 响应旋转表冠事件的低旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。

mTimeChangedListener

protected TimePicker.TimeChangedListener mTimeChangedListener

指示监听器 TimePicker.TimeChangedListener 监听所选时间的变化。

构造函数详细信息

TimePicker

public TimePicker(Context context)

用于使用默认属性集和样式创建 TimePicker 实例的默认构造函数。

参数：

参数名称	参数描述
context	指示应用程序上下文。

TimePicker

public TimePicker(Context context, AttrSet attrSet)

用于在 XML 文件解析后使用指定的属性集和默认样式创建 TimePicker 实例的构造函数。

参数：

参数名称	参数描述
context	指示应用程序上下文。
attrSet	指示要使用的属性集。

TimePicker

public TimePicker(Context context, AttrSet attrSet, String styleName)

用于在 XML 文件解析后使用指定的属性集和指定的样式创建 TimePicker 实例的构造函数。

参数：

参数名称	参数描述
context	指示应用程序上下文。
attrSet	指示要使用的属性集。
styleName	指示要使用的样式名称。

方法详情

isHourEnabled

public boolean isHourEnabled()

获取是否启用小时选择器。

返回:

如果启用了小时选择器，则返回 true； 否则返回 false。

enableHour

public void enableHour(boolean enable)

设置是否启用小时选择器。

参数：

参数名称	参数描述
enable	指定是否启用小时选择器。 值 true 表示启用小时选择器，值 false 表示禁用小时选择器。

showHour

public void showHour(boolean show)

设置是否显示小时选择器。

参数：

参数名称	参数描述
show	指定是否显示小时选择器。 值 true 表示显示小时选择器，值 false 表示隐藏小时选择器。

isHourShown

public boolean isHourShown()

获取小时选择器的状态。

返回:

如果显示小时选择器，则返回 true； 否则返回 false。

isMinuteEnabled

public boolean isMinuteEnabled()

获取分钟选择器是否启用。

返回:

如果启用了分钟选择器，则返回 true； 否则返回 false。

enableMinute

public void enableMinute(boolean enable)

设置是否启用分钟选择器。

参数：

参数名称	参数描述
enable	指定是否启用分钟选择器。 值 true 表示启用分钟选择器，值 false 表示禁用分钟选择器。

showMinute

public void showMinute(boolean show)

设置是否显示分钟选择器。

参数：

参数名称	参数描述
show	指定是否显示分钟选择器。 值 true 表示显示分钟选择器，值 false 表示隐藏分钟选择器。

isMinuteShown

public boolean isMinuteShown()

获取分钟选择器的状态。

返回:

如果显示分钟选择器，则返回 true； 否则返回 false。

isSecondEnabled

public boolean isSecondEnabled()

获取是否启用了第二个选择器。

返回:

如果启用了第二个选择器，则返回 true； 否则返回 false。

enableSecond

public void enableSecond(boolean enable)

设置是否启用第二个选择器。

参数：

参数名称	参数描述
enable	指定是否启用第二个选择器。 值 true 表示启用第二个选择器，值 false 表示禁用第二个选择器。

showSecond

public void showSecond(boolean show)

设置是否显示第二个选择器。

参数：

参数名称	参数描述
show	指定是否显示第二个选择器。 值 true 表示显示第二个选择器，值 false 表示隐藏第二个选择器。

isSecondShown

public boolean isSecondShown()

获取第二个选择器的状态。

返回:

如果显示第二个选择器，则返回 true； 否则返回 false。

getHour

public int getHour()

获取选定的小时。

返回:

返回选定的小时。

setHour

public void setHour(int hour)

设置选定的小时。

参数：

参数名称	参数描述
hour	表示选定的小时。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果小时参数小于 0 或大于 23，则抛出此异常。

getMinute

public int getMinute()

获取选定的分钟。

返回:

返回选定的分钟。

setMinute

public void setMinute(int minute)

设置选定的分钟。

参数：

参数名称	参数描述
minute	表示选择的分钟。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果分钟参数小于 0 或大于 59，则抛出此异常。

getSecond

public int getSecond()

获得选定的秒数。

返回:

返回选定的秒数。

setSecond

public void setSecond(int second)

设置选定的秒数。

参数：

参数名称	参数描述
second	表示选择的秒数。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果第二个参数小于 0 或大于 59，则抛出此异常。

set24Hour

public void set24Hour(boolean is24Hour)

设置是否以 24 小时制显示时间。

参数：

参数名称	参数描述
is24Hour	指定时间是否以 24 小时模式显示。 true表示时间以24小时制显示，false表示时间不以24小时制显示。

is24Hour

public boolean is24Hour()

获取时间是否以 24 小时制显示。

返回:

如果时间以 24 小时模式显示，则返回 true； 否则返回 false。 默认值是true。

setTimeChangedListener

public void setTimeChangedListener(TimePicker.TimeChangedListener listener)

设置侦听器 TimePicker.TimeChangedListener 以侦听所选时间的变化。

参数：

参数名称	参数描述
listener	指示监听器监听所选时间的变化。

setRange

public void setRange(int[] ranges)

设置可选择的时间范围。 时间范围按以下顺序排列在数组中：开始小时、开始分钟、开始秒、结束小时、结束分钟和结束秒。

参数：

参数名称	参数描述
ranges	表示可以选择的时间范围。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果输入参数无效，则抛出此异常：如果 range 为 null 或者 range.length 不等于 6 或者 range[0] "starting hour" 小于 0 或大于 23 或者 range[1] "starting 分钟”小于 0 或大于 59 或范围 [2] “开始秒”小于 0 或大于 59 或范围 [3] “结束小时”小于 0 或大于 23 或范围 [ 4] “结束分钟”小于 0 或大于 59，或者如果范围 [5] “结束秒”小于 0 或大于 59。

getRange

public void getRange(int[] ranges)

获取可选择的时间范围。 时间范围来自分配给输入数组的值，并按以下顺序返回：开始小时、开始分钟、开始秒、结束小时、结束分钟和结束秒。

参数：

参数名称	参数描述
ranges	表示可以选择的时间范围。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果输入参数无效，则抛出此异常。

setNormalTextSize

public void setNormalTextSize(int size)

设置时间选择器中显示的时间的正常字体大小。

参数：

参数名称	参数描述
size	指示时间选择器中显示的时间的正常字体大小。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果输入参数无效，则抛出此异常。

Since:

2

getNormalTextSize

public int getNormalTextSize()

获取时间选择器中显示的时间的正常字体大小。

返回:

时间选择器中显示的时间的正常字体大小。

Since:

2

setSelectedTextSize

public void setSelectedTextSize(int size)

设置时间选择器中显示的时间的选定字体大小。

参数：

参数名称	参数描述
size	指示时间选择器中显示的时间的选定字体大小。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果输入参数无效，则抛出此异常。

Since:

2

getSelectedTextSize

public int getSelectedTextSize()

获取时间选择器中显示的时间的选定字体大小。

返回:

时间选择器中显示的时间的选定字体大小。

Since:

2

setNormalTextColor

public void setNormalTextColor(Color color)

设置时间选择器中显示的时间的正常字体颜色。

参数：

参数名称	参数描述
color	指示时间选择器中显示的时间的正常字体颜色。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果颜色参数为空，则引发此异常。

Since:

2

getNormalTextColor

public Color getNormalTextColor()

获取时间选择器中显示的时间的正常字体颜色。

返回:

时间选择器中显示的时间的正常字体颜色。

Since:

2

setSelectedTextColor

public void setSelectedTextColor(Color color)

设置时间选择器中显示的时间的选定字体颜色。

参数：

参数名称	参数描述
color	指示时间选择器中显示的时间的选定字体颜色。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果颜色参数为空，则引发此异常。

Since:

2

getSelectedTextColor

public Color getSelectedTextColor()

获取时间选择器中显示的时间的选定字体颜色。

返回:

时间选择器中显示的时间的选定字体颜色。

Since:

2

setOperatedTextColor

public void setOperatedTextColor(Color color)

设置时间选择器中操作文本的颜色。

参数：

参数名称	参数描述
color	指示要设置的颜色。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果颜色参数为空，则引发此异常。

Since:

3

getOperatedTextColor

public Color getOperatedTextColor()

获取时间选择器中被操作文本的颜色。

返回:

返回操作文本的颜色。

Since:

3

setNormalTextFont

public void setNormalTextFont(Font font)

设置此时间选择器中普通文本的字体。

参数：

参数名称	参数描述
font	指示要设置的字体。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果字体参数为空，则引发此异常。

Since:

4

getNormalTextFont

public Font getNormalTextFont()

获取此时间选择器中普通文本的字体。

返回:

返回普通文本的字体。

Since:

4

setSelectedTextFont

public void setSelectedTextFont(Font font)

设置此时间选择器中选定文本的字体。

参数：

参数名称	参数描述
font	指示要设置的字体。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果字体参数为空，则引发此异常。

Since:

4

getSelectedTextFont

public Font getSelectedTextFont()

获取此时间选择器中选定文本的字体。

返回:

返回所选文本的字体。

Since:

4

setSelectedTextBackground

public void setSelectedTextBackground(Element element)

将指定的 Element 设置为此时间选择器中选定文本的背景。

参数：

参数名称	参数描述
element	指示要设置的元素。

Since:

4

getSelectedTextBackgroundElement

public Element getSelectedTextBackgroundElement()

获取元素集作为在此时间选择器中选择的文本的背景。

返回:

返回元素。

Since:

4

setOperatedTextBackground

public void setOperatedTextBackground(Element element)

将指定的 Element 设置为正在操作的选中项的文本背景。

参数：

参数名称	参数描述
element	指示要设置的元素。

Since:

4

getOperatedTextBackgroundElement

public Element getOperatedTextBackgroundElement()

获取元素集作为正在操作的选中项的文本背景。

返回:

返回元素。

Since:

4

setSelectedNormalTextMarginRatio

public void setSelectedNormalTextMarginRatio(float textMarginRatio)

在此时间选择器中设置所选文本边距与正常文本边距的比率。

参数：

参数名称	参数描述
textMarginRatio	表示要设置的比率。 该值必须大于或等于 0.0f。 默认值为 1.0f。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果 textMarginRatio 参数小于 0，则抛出此异常。

Since:

3

getSelectedNormalTextMarginRatio

public float getSelectedNormalTextMarginRatio()

获取此时间选择器中选定文本与正常文本边距的比率。

返回:

返回比率。

Since:

3

setDisplayedLinesElements

public void setDisplayedLinesElements(Element top, Element bottom)

设置一个 Element 实例以在时间选择器中为选定文本绘制分割线。

参数：

参数名称	参数描述
top	指示要在所选文本顶部绘制分割线的 Element 实例。
bottom	指示要在所选文本底部绘制分割线的 Element 实例。

Since:

4

getDisplayedTopElement

public Element getDisplayedTopElement()

获取此时间选择器中顶部分割线的 Element 实例。

返回:

返回元素实例。

Since:

4

getDisplayedBottomElement

public Element getDisplayedBottomElement()

获取用于在时间选择器中选定数字的底部绘制分割线的 Element 实例。

返回:

返回用于在所选数字底部绘制分割线的 Element 实例。

Since:

4

getDisplayedLinesElements

public Element[] getDisplayedLinesElements()

获取用于在此时间选择器中绘制分割线的实例数组。

返回:

返回用于绘制分割线的 Element 实例数组。

Since:

4

setDisplayedTopElement

public void setDisplayedTopElement(Element top)

在此时间选择器中设置所选数字顶部的分割线。

参数：

参数名称	参数描述
top	指示要设置的顶部分割线。

Since:

4

setDisplayedBottomElement

public void setDisplayedBottomElement(Element bottom)

将分割线设置在此时间选择器中选定数字的底部。

参数：

参数名称	参数描述
bottom	指示要设置的底部分割线。

Since:

4

setAmPmStrings

public void setAmPmStrings(String am, String pm)

设置代表 a.m. 和 p.m. 的字符串。

参数：

参数名称	参数描述
am	表示代表 a.m. 的字符串。
pm	表示代表 p.m. 的字符串。

Since:

2

setAmString

public void setAmString(String am)

设置代表上午的字符串。

参数：

参数名称	参数描述
am	表示代表 a.m 的字符串。

Since:

4

setPmString

public void setPmString(String pm)

设置代表下午的字符串。

参数：

参数名称	参数描述
pm	表示代表 p.m 的字符串。

Since:

4

getAmPmStrings

public String[] getAmPmStrings()

获取表示上午和下午的字符串数组。

返回:

返回指示 a.m. 和 p.m. 的字符串数组。

Since:

2

getAmString

public String getAmString()

获取代表 a.m 的字符串。

返回:

返回代表 a.m 的字符串。

Since:

4

getPmString

public String getPmString()

获取代表 p.m 的字符串。

返回:

返回代表 p.m 的字符串。

Since:

4

getTimeChangedListener

public TimePicker.TimeChangedListener getTimeChangedListener()

获取用于监听该picker时间变化事件的回调对象。

返回:

返回回调对象。

Since:

4

setWheelModeEnabled

public void setWheelModeEnabled(boolean isEnabled)

设置是否为时间选择器的选择轮启用轮模式。 如果启用，则最大值环绕最小值。

参数：

参数名称	参数描述
isEnabled	指示是否启用滚轮模式。 true 表示启用滚轮模式； false 表示其他情况。

Since:

4

isWheelModeEnabled

public boolean isWheelModeEnabled()

获取时间选择器的选择轮是否启用轮模式。

返回:

如果启用了滚轮模式，则返回 true； 否则返回 false。

Since:

4

setShaderColor

public void setShaderColor(Color color)

为时间选择器设置着色器颜色。

参数：

参数名称	参数描述
color	指示着色器颜色。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果颜色参数为空，则引发此异常。

Since:

3

getShaderColor

public Color getShaderColor()

获取时间选择器的着色器颜色。

返回:

返回时间选择器的着色器颜色。

Since:

3

setSelectorItemNum

public void setSelectorItemNum(int itemNum)

设置要在选择器上显示的项目数。

参数：

参数名称	参数描述
itemNum	指示要在选择器上显示的项目数。 该值必须大于 0。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果要在选择器上显示的项目数小于或等于 0，则引发此异常。

Since:

4

getSelectorItemNum

public int getSelectorItemNum()

获取选择器上显示的项目数。

返回:

返回选择器上显示的项目数； 如果未指定数字，则返回默认值 0。

Since:

4

setAmPmOrder

public void setAmPmOrder(TimePicker.AmPmOrder order)

设置表示上午和下午的列的格式。 在时间选择器中。

代表上午和下午的列 通过指定值 AmPmOrder#START 或 AmPmOrder#END，可以在选取器的开头或结尾显示。 AmPmOrder#START 和 AmPmOrder#END 的方向（从左到右或从右到左）取决于指定的 Component.isRtl() 值。 通过指定 AmPmOrder#LEFT 或 AmPmOrder#RIGHT，该列也可以显示在时间选择器的左侧或右侧。

参数：

参数名称	参数描述
order	表示AmPmOrder枚举值，可以是AmPmOrder#START、AmPmOrder#END、AmPmOrder#LEFT或AmPmOrder#RIGHT。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果 order 参数为 null，则引发此异常。

Since:

3

getAmPmOrder

public TimePicker.AmPmOrder getAmPmOrder()

获取时间选择器中表示上午和下午的列的格式。

代表上午和下午的列 可以通过指定值 AmPmOrder#START 或 AmPmOrder#END 显示在选取器的开头或结尾。AmPmOrder#START 和 AmPmOrder#END 的方向（从左到右或从右到左）取决于 指定的 Component.isRtl() 值。

返回:

返回 AmPmOrder 枚举值，可以是 AmPmOrder#START、AmPmOrder#END、AmPmOrder#LEFT 或 AmPmOrder#RIGHT。

Since:

3