Most visited

Recently visited

Results for

Added in API level 17

TextClock

public class TextClock
extends TextView

java.lang.Object
↳	android.view.View
	↳	android.widget.TextView
		↳	android.widget.TextClock

TextClock可以将当前日期和/或时间显示为格式化的字符串。

该视图尊重24小时制系统设置。因此，建议您提供两种不同的格式：一种以24小时模式显示日期/时间，另一种以12小时模式显示日期/时间。大多数呼叫者会希望使用默认值，但这对用户的区域设置是适合的。

通过调用 is24HourModeEnabled()可以确定系统当前是否处于24小时模式。

这个小部件用来决定如何格式化日期和时间的规则如下：

In 24-hour mode:
- Use the value returned by getFormat24Hour() when non-null
- Otherwise, use the value returned by getFormat12Hour() when non-null
- Otherwise, use a default value appropriate for the user's locale, such as h:mm a
In 12-hour mode:
- Use the value returned by getFormat12Hour() when non-null
- Otherwise, use the value returned by getFormat24Hour() when non-null
- Otherwise, use a default value appropriate for the user's locale, such as HH:mm

在调用setFormat24Hour(CharSequence)或setFormat12Hour(CharSequence)时用作格式化模式的CharSequence实例可以包含样式信息。为此，请使用Spanned对象。请注意，如果您自定义这些字符串，则您有责任提供适合用户格式化日期和/或时间的字符串。

Summary

XML attributes
`android:format12Hour`	Specifies the formatting pattern used to show the time and/or date in 12-hour mode.
`android:format24Hour`	Specifies the formatting pattern used to show the time and/or date in 24-hour mode.
`android:timeZone`	Specifies the time zone to use.

Inherited XML attributes

From class android.widget.TextView

`android:autoLink`	Controls whether links such as urls and email addresses are automatically found and converted to clickable links.
`android:autoText`	If set, specifies that this TextView has a textual input method and automatically corrects some common spelling errors.
`android:breakStrategy`	Break strategy (control over paragraph layout).
`android:bufferType`	Determines the minimum type that getText() will return.
`android:capitalize`	If set, specifies that this TextView has a textual input method and should automatically capitalize what the user types.
`android:cursorVisible`	Makes the cursor visible (the default) or invisible.
`android:digits`	If set, specifies that this TextView has a numeric input method and that these specific characters are the ones that it will accept.
`android:drawableBottom`	The drawable to be drawn below the text.
`android:drawableEnd`	The drawable to be drawn to the end of the text.
`android:drawableLeft`	The drawable to be drawn to the left of the text.
`android:drawablePadding`	The padding between the drawables and the text.
`android:drawableRight`	The drawable to be drawn to the right of the text.
`android:drawableStart`	The drawable to be drawn to the start of the text.
`android:drawableTint`	Tint to apply to the compound (left, top, etc.) drawables.
`android:drawableTintMode`	Blending mode used to apply the compound (left, top, etc.) drawables tint.
`android:drawableTop`	The drawable to be drawn above the text.
`android:editable`	If set, specifies that this TextView has an input method.
`android:editorExtras`	Reference to an `<input-extras>` XML resource containing additional data to supply to an input method, which is private to the implementation of the input method.
`android:elegantTextHeight`	Elegant text height, especially for less compacted complex script text.
`android:ellipsize`	If set, causes words that are longer than the view is wide to be ellipsized instead of broken in the middle.
`android:ems`	Makes the TextView be exactly this many ems wide.
`android:fontFamily`	Font family (named by string) for the text.
`android:fontFeatureSettings`	Font feature settings.
`android:freezesText`	If set, the text view will include its current complete text inside of its frozen icicle in addition to meta-data such as the current cursor position.
`android:gravity`	Specifies how to align the text by the view's x- and/or y-axis when the text is smaller than the view.
`android:height`	Makes the TextView be exactly this many pixels tall.
`android:hint`	Hint text to display when the text is empty.
`android:hyphenationFrequency`	Frequency of automatic hyphenation.
`android:imeActionId`	Supply a value for `EditorInfo.actionId` used when an input method is connected to the text view.
`android:imeActionLabel`	Supply a value for `EditorInfo.actionLabel` used when an input method is connected to the text view.
`android:imeOptions`	Additional features you can enable in an IME associated with an editor to improve the integration with your application.
`android:includeFontPadding`	Leave enough room for ascenders and descenders instead of using the font ascent and descent strictly.
`android:inputMethod`	If set, specifies that this TextView should use the specified input method (specified by fully-qualified class name).
`android:inputType`	The type of data being placed in a text field, used to help an input method decide how to let the user enter text.
`android:letterSpacing`	Text letter-spacing.
`android:lineSpacingExtra`	Extra spacing between lines of text.
`android:lineSpacingMultiplier`	Extra spacing between lines of text, as a multiplier.
`android:lines`	Makes the TextView be exactly this many lines tall.
`android:linksClickable`	If set to false, keeps the movement method from being set to the link movement method even if autoLink causes links to be found.
`android:marqueeRepeatLimit`	The number of times to repeat the marquee animation.
`android:maxEms`	Makes the TextView be at most this many ems wide.
`android:maxHeight`	Makes the TextView be at most this many pixels tall.
`android:maxLength`	Set an input filter to constrain the text length to the specified number.
`android:maxLines`	Makes the TextView be at most this many lines tall.
`android:maxWidth`	Makes the TextView be at most this many pixels wide.
`android:minEms`	Makes the TextView be at least this many ems wide.
`android:minHeight`	Makes the TextView be at least this many pixels tall.
`android:minLines`	Makes the TextView be at least this many lines tall.
`android:minWidth`	Makes the TextView be at least this many pixels wide.
`android:numeric`	If set, specifies that this TextView has a numeric input method.
`android:password`	Whether the characters of the field are displayed as password dots instead of themselves.
`android:phoneNumber`	If set, specifies that this TextView has a phone number input method.
`android:privateImeOptions`	An addition content type description to supply to the input method attached to the text view, which is private to the implementation of the input method.
`android:scrollHorizontally`	Whether the text is allowed to be wider than the view (and therefore can be scrolled horizontally).
`android:selectAllOnFocus`	If the text is selectable, select it all when the view takes focus.
`android:shadowColor`	Place a blurred shadow of text underneath the text, drawn with the specified color.
`android:shadowDx`	Horizontal offset of the text shadow.
`android:shadowDy`	Vertical offset of the text shadow.
`android:shadowRadius`	Blur radius of the text shadow.
`android:singleLine`	Constrains the text to a single horizontally scrolling line instead of letting it wrap onto multiple lines, and advances focus instead of inserting a newline when you press the enter key.
`android:text`	Text to display.
`android:textAllCaps`	Present the text in ALL CAPS.
`android:textAppearance`	Base text color, typeface, size, and style.
`android:textColor`	Text color.
`android:textColorHighlight`	Color of the text selection highlight.
`android:textColorHint`	Color of the hint text.
`android:textColorLink`	Text color for links.
`android:textIsSelectable`	Indicates that the content of a non-editable text can be selected.
`android:textScaleX`	Sets the horizontal scaling factor for the text.
`android:textSize`	Size of the text.
`android:textStyle`	Style (bold, italic, bolditalic) for the text.
`android:typeface`	Typeface (normal, sans, serif, monospace) for the text.
`android:width`	Makes the TextView be exactly this many pixels wide.

From class android.view.View

Inherited constants

From class android.view.View

Fields
`public static final CharSequence`	`DEFAULT_FORMAT_12_HOUR` 该字段在API级别18中已弃用。让系统使用适合区域设置的默认值。
`public static final CharSequence`	`DEFAULT_FORMAT_24_HOUR` 该字段在API级别18中已弃用。让系统使用适合区域设置的默认值。

Inherited fields

From class android.view.View

Public constructors
`TextClock(Context context)` 使用当前语言环境的默认模式创建新时钟。
`TextClock(Context context, AttributeSet attrs)` 创建一个从XML扩展的新时钟。
`TextClock(Context context, AttributeSet attrs, int defStyleAttr)` 创建一个从XML扩展的新时钟。
`TextClock(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)`

Public methods
`CharSequence`	`getFormat12Hour()` 返回用于在12小时模式下显示日期和/或时间的格式模式。
`CharSequence`	`getFormat24Hour()` 返回用于以24小时模式显示日期和/或时间的格式模式。
`String`	`getTimeZone()` 指示此视图当前使用哪个时区。
`boolean`	`is24HourModeEnabled()` 指示系统当前是否正在使用24小时模式。
`void`	`setFormat12Hour(CharSequence format)` 指定用于以12小时模式显示日期和/或时间的格式化模式。
`void`	`setFormat24Hour(CharSequence format)` 指定用于以24小时模式显示日期和/或时间的格式化模式。
`void`	`setTimeZone(String timeZone)` 设置在此时钟中使用的指定时区。

Protected methods
`void`	`onAttachedToWindow()` 这在视图附加到窗口时被调用。
`void`	`onDetachedFromWindow()` 这是在视图从窗口分离时调用的。

Inherited methods

From class android.widget.TextView

From class android.view.View

From class java.lang.Object

From interface android.view.ViewTreeObserver.OnPreDrawListener

From interface android.graphics.drawable.Drawable.Callback

From interface android.view.KeyEvent.Callback

From interface android.view.accessibility.AccessibilityEventSource

XML attributes

android:format12Hour

指定用于在12小时模式下显示时间和/或日期的格式化模式。请参阅DateFormat以获取可接受格式模式的完整说明。默认模式是“h：mm a”的语言环境适当的等效项。

必须是字符串值，使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 format12Hour 。

相关方法：

setFormat12Hour(CharSequence)

android:format24Hour

指定用于以24小时模式显示时间和/或日期的格式化模式。请参阅DateFormat了解可接受格式模式的完整说明。默认模式是“H：mm”的语言环境适当的等效。

必须是字符串值，使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可以是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 format24Hour 。

相关方法：

setFormat24Hour(CharSequence)

android:timeZone

指定要使用的时区。当指定此属性时，TextClock将忽略系统的时区。要使用用户的时区，请不要指定此属性。默认值是用户的时区。有关时区ID的更多信息，请参阅TimeZone 。

必须是字符串值，使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 timeZone 。

相关方法：

setTimeZone(String)

Fields

DEFAULT_FORMAT_12_HOUR

Added in API level 17

CharSequence DEFAULT_FORMAT_12_HOUR

此字段在API级别18中已被弃用。
让系统使用适合区域设置的默认值。

12小时模式下的默认格式模式。如果使用空模式调用setFormat12Hour(CharSequence) ，或者在创建此类的实例时未指定模式，则使用此模式。此默认模式仅显示时间，小时和分钟以及am / pm指标。

也可以看看：

DEFAULT_FORMAT_24_HOUR

Added in API level 17

CharSequence DEFAULT_FORMAT_24_HOUR

此字段在API级别18中已被弃用。
让系统使用适合区域设置的默认值。

24小时模式下的默认格式模式。如果使用空模式调用setFormat24Hour(CharSequence) ，或者在创建此类的实例时未指定模式，则使用此模式。此默认模式仅显示时间，小时数和分钟数。

也可以看看：

Public constructors

TextClock

Added in API level 17

TextClock (Context context)

使用当前语言环境的默认模式创建新时钟。

Parameters
`context`	`Context`: The Context the view is running in, through which it can access the current theme, resources, etc.

TextClock

Added in API level 17

TextClock (Context context, 
                AttributeSet attrs)

创建一个从XML扩展的新时钟。该对象的属性是从XML中指定的属性初始化的。此构造函数使用默认样式0，因此所应用的唯一属性值是Context's Theme和给定AttributeSet中的值。

Parameters
`context`	`Context`: The Context the view is running in, through which it can access the current theme, resources, etc.
`attrs`	`AttributeSet`: The attributes of the XML tag that is inflating the view

TextClock

Added in API level 17

TextClock (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

创建一个从XML扩展的新时钟。该对象的属性是从XML中指定的属性初始化的。

Parameters
`context`	`Context`: The Context the view is running in, through which it can access the current theme, resources, etc.
`attrs`	`AttributeSet`: The attributes of the XML tag that is inflating the view
`defStyleAttr`	`int`: An attribute in the current theme that contains a reference to a style resource that supplies default values for the view. Can be 0 to not look for defaults.

TextClock

Added in API level 21

TextClock (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes)

Parameters
`context`	`Context`
`attrs`	`AttributeSet`
`defStyleAttr`	`int`
`defStyleRes`	`int`

Public methods

getFormat12Hour

Added in API level 17

CharSequence getFormat12Hour ()

返回用于在12小时模式下显示日期和/或时间的格式模式。格式化模式语法在DateFormat描述。

Returns
`CharSequence`	A `CharSequence` or null.

也可以看看：

getFormat24Hour

Added in API level 17

CharSequence getFormat24Hour ()

返回用于以24小时模式显示日期和/或时间的格式模式。格式化模式语法在DateFormat描述。

Returns
`CharSequence`	A `CharSequence` or null.

也可以看看：

getTimeZone

Added in API level 17

String getTimeZone ()

指示此视图当前使用哪个时区。

Returns
`String`	The ID of the current time zone or null if the default time zone, as set by the user, must be used

也可以看看：

is24HourModeEnabled

Added in API level 17

boolean is24HourModeEnabled ()

指示系统当前是否正在使用24小时模式。当系统处于24小时模式时，此视图将使用由getFormat24Hour()返回的getFormat24Hour() 。在12小时模式下，将使用由getFormat12Hour()返回的模式。如果其中任何一种格式为空，则使用其他格式。如果两种格式都为空，则使用当前语言环境的默认格式。

Returns
`boolean`	true if time should be displayed in 24-hour format, false if it should be displayed in 12-hour format.

也可以看看：

setFormat12Hour

Added in API level 17

void setFormat12Hour (CharSequence format)

指定用于以12小时模式显示日期和/或时间的格式化模式。格式化模式语法在DateFormat描述。

如果此模式设置为空，则即使在12小时模式下也将使用getFormat24Hour() 。如果将24小时格式和12小时格式设置为空，则将使用当前语言环境的默认格式。

注意：如果不需要样式，强烈建议您提供由getBestDateTimePattern(java.util.Locale, String)生成的格式字符串。此方法负责生成适用于所需语言环境的格式字符串。

相关XML属性：

android:format12Hour

Parameters
`format`	`CharSequence`: A date/time formatting pattern as described in `DateFormat`

也可以看看：

setFormat24Hour

Added in API level 17

void setFormat24Hour (CharSequence format)

指定用于以24小时模式显示日期和/或时间的格式化模式。格式化模式语法在DateFormat描述。

如果此模式设置为空，则即使在12小时模式下也会使用getFormat24Hour() 。如果将24小时格式和12小时格式设置为空，则将使用当前语言环境的默认格式。

相关XML属性：

android:format24Hour

Parameters
`format`	`CharSequence`: A date/time formatting pattern as described in `DateFormat`

也可以看看：

setTimeZone

Added in API level 17

void setTimeZone (String timeZone)

设置在此时钟中使用的指定时区。当通过此方法设置时区时，系统时区更改（例如，用户在设置中设置时区时）将被忽略。

相关XML属性：

android:timeZone

Parameters
`timeZone`	`String`: The desired time zone's ID as specified in `TimeZone` or null to user the time zone specified by the user (system time zone)

也可以看看：

Protected methods

onAttachedToWindow

Added in API level 17

void onAttachedToWindow ()

这在视图附加到窗口时被调用。此时它有一个Surface并将开始绘制。注意这个函数保证在onDraw(android.graphics.Canvas)之前被调用，但是它可以在第一次onDraw之前的任何时候调用 - 包括在onMeasure(int, int)之前或之后。

onDetachedFromWindow

Added in API level 17

void onDetachedFromWindow ()

这是在视图从窗口分离时调用的。此时它不再有绘图表面。