学习Android的第十三天-Android TextClock 文本时钟控件

Android TextClock 是一个用于在 Android 应用中显示当前日期和时间的控件。它在 Android 4.2 (API 17) 后推出，并提供了两种不同的格式：24 小时制和 12 小时制。

可以使用 is24HourModeEnabled() 方法来确定系统当前是否在使用 24 小时制。在 24 小时制模式下，系统将按照以下方式进行判断：

首先尝试通过 getFormat24Hour() 方法获取时间格式。
如果无法获取到时间格式，则尝试通过 getFormat12Hour() 方法获取时间格式。
如果上述两种方式都无法获取到时间格式，则使用默认格式。

TextClock 控件主要属性和方法

下面是 TextClock 控件的主要属性和对应的方法：

属性：

android:format12Hour：设置 12 小时制的格式。
android:format24Hour：设置 24 小时制的格式。
android:timeZone：设置时区。

方法：

setFormat12Hour(CharSequence format)：设置 12 小时制的时间格式。参数 format 是一个 CharSequence 对象，用于指定要显示的时间格式。
setFormat24Hour(CharSequence format)：设置 24 小时制的时间格式。参数 format 是一个 CharSequence 对象，用于指定要显示的时间格式。
setTimeZone(String timeZone)：设置 TextClock 控件的时区。参数 timeZone 是一个字符串，表示要设置的时区。

简单的 TextClock

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:orientation="vertical"
    android:gravity="center">

        <TextClock
            android:id="@+id/textClock"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:textSize="24sp"
            android:format24Hour="HH:mm:ss"
            android:format12Hour="hh:mm:ss a"
            android:timeZone="GMT+08:00"/>
</LinearLayout>

参考文档

Android android.widget.TextClock