文本时钟框组件操作实例讲解

作者：创世魂

本类是一个可视化组件。

当前组件上会显示当前手机时间。

显示格式可通过“二十四小时格式”或“十二小时格式”等属性决定。

默认以当前系统的时间格式显示。

注意：本类位于“安卓基本类”模块中，必须添加此模块才能使用。

拖放两个“按钮”和一个“文本时钟框”。

帮助文档如下图：

本方法的作用是用来判断，当前手机系统的时间格式。

返回真，表示当前手机为24小时格式，否则返回假。

代码编写如下图：

直接判断本方法的返回值，然后弹出对应提示即可。

运行结果如下图：

无论是系统时间，“文本时钟框”显示时间，还是弹出的提示，都是24小时格式。

“二十四小时格式（读写）”帮助文档：

当前系统时间如果是“24小时格式”，那么本写属性的作用是用来设置，24小时的显示格式。

属性值通过“日历类.常用格式X”来指定。

注意：当前系统时间如果为“12小时格式”，那么本属性无效。

同名的读属性，就是读取当前设置的“常用格式”。

“十二小时格式（读写）”帮助文档：

同样的，本属性只能设置系统时间为“12小时格式”的。

注意：当前系统时间如果为“24小时格式”，那么本属性无效。

同名的读属性，就是读取当前设置的“常用格式”。

代码编写如下图：

首先调用“为二十四小时模式（）”方法，判断当前系统时间是否为“二十小时格式”。

如果是24小时，则设置“二十四小时格式”的属性值为“日历类.常用格式1”。

然后调用“如果”判断是否设置成功。

如果当前不为24小时，则设置“十二小时格式”的属性值为“日历类.常用格式2”。

然后调用“如果”判断是否设置成功。

运行结果（1）：

可以看到右上角显示时间为24小时格式，因此修改的时间格式也是24小时格式。

运行结果（2）：

如果把当前系统时间改为“12小时格式”的，此时会修改“十二小时格式”的属性值。

“时区（写）”帮助文档：

顾名思义，设置当前时区。

如果属性值为“空对象”或不调用本属性，则默认时区为当前系统的时区。

注意：设置时区后，手动修改系统时区，本组件将不会自动同步时区。

“时区（读）”帮助文档：

顾名思义，读取当前时区。

如果未设置，则返回“空对象”，否则返回当前设置的“时区”。

代码编写如下图：

“按钮1”被点击后，设置“时区”属性值为“America/New_York”即美国纽约时区。

“按钮2”被点击后，首先判断当前“时区”是否为空对象。

如果不是空对象则弹出当前时区。

运行结果如下图（GIF）：

首先点击“按钮2”会提示“当前是默认时区”。

随后点击“按钮1”，会发现时钟时间从“下午六点”变成了“上午六点”。

上午六点正是美国纽约的时区。

再次点击“按钮2”的时候，就会弹出设置的美国纽约时区。