鸿蒙NEXT开发案例：世界时间表

 

【引言】

本案例将展示如何使用鸿蒙NEXT框架开发一个简单的世界时钟应用程序。该应用程序能够展示多个城市的当前时间，并支持搜索功能，方便用户快速查找所需城市的时间信息。在本文中，我们将详细介绍应用程序的实现思路，包括如何获取时区信息、更新城市时间、以及如何实现搜索高亮功能。

【环境准备】

• 操作系统：Windows 10

• 开发工具：DevEco Studio NEXT Beta1 Build Version: 5.0.3.806

• 目标设备：华为Mate60 Pro

• 开发语言：ArkTS

• 框架：ArkUI

• API版本：API 12

【实现思路】

1. 组件结构设计

我们的应用程序主要由两个核心组件构成：CityTimeInfo类和WorldClockApp组件。CityTimeInfo类用于存储每个城市的名称、当前时间和时区信息。WorldClockApp组件则负责管理城市时间列表、搜索功能以及用户界面。

2. 获取时区信息

在应用程序启动时，我们需要获取可用的时区信息。通过调用i18n.TimeZone.getAvailableIDs()方法，我们可以获取所有可用的时区ID。接着，我们使用这些ID创建CityTimeInfo实例，并将其添加到城市时间列表中。为了确保用户能够看到当前时间，我们还添加了北京的时间信息作为默认城市。

3. 更新时间逻辑

为了实时更新城市的当前时间，我们在updateAllCityTimes方法中实现了时间更新逻辑。通过获取系统的语言环境和相应的日历对象，我们可以根据城市的时区ID获取当前的年、月、日、时、分、秒，并将其格式化为字符串。这个方法会在页面显示时每秒调用一次，确保时间信息的准确性。

4. 搜索功能实现

为了提升用户体验，我们实现了搜索功能，允许用户通过输入关键词来筛选城市。在highlightSearchText方法中，我们对城市名称进行分段处理，将匹配的关键词高亮显示。通过这种方式，用户可以快速找到所需的城市，并且高亮的文本能够提供更好的视觉反馈。

5. 用户界面构建

最后，我们使用build方法构建用户界面。界面包括一个搜索框、城市名称和时间的显示区域。我们使用了Column和Row组件来布局，并通过设置样式属性来美化界面。滚动区域的实现使得用户可以方便地浏览多个城市的信息。

【完整代码】

import { i18n } from '@kit.LocalizationKit' // 导入国际化模块，用于处理多语言 import { inputMethod } from '@kit.IMEKit' // 导入输入法模块  @ObservedV2   // 观察者装饰器，用于观察状态变化 class CityTimeInfo { // 定义城市时间信息类   @Trace cityName: string = ""; // 城市名称，初始为空字符串   @Trace currentTime: string = ""; // 当前时间，初始为空字符串   timeZone: i18n.TimeZone; // 时区属性    constructor(cityName: string, timeZone: i18n.TimeZone) { // 构造函数，接收城市名称和时区     this.cityName = cityName; // 设置城市名称     this.timeZone = timeZone; // 设置时区   }    @Trace isVisible: boolean = true; // 是否可见，初始为true }  @Entry   // 入口组件装饰器 @Component   // 组件装饰器 struct WorldClockApp { // 定义世界时钟应用组件   @State private searchText: string = ''; // 搜索文本，初始为空字符串   @State private cityTimeList: CityTimeInfo[] = []; // 城市时间信息列表，初始为空数组   private lineColor: string = "#e6e6e6"; // 边框颜色   private titleBackgroundColor: string = "#f8f8f8"; // 标题背景色   private textColor: string = "#333333"; // 文字颜色   private basePadding: number = 4; // 内边距   private lineWidth: number = 2; // 边框宽度   private rowHeight: number = 50; // 行高   private ratio: number[] = [1, 1]; // 列宽比例   private textSize: number = 14; // 基础字体大小   private updateIntervalId = 0; // 更新间隔ID    updateAllCityTimes() { // 更新所有城市的时间     const locale = i18n.System.getSystemLocale(); // 获取系统语言环境     for (const cityTime of this.cityTimeList) { // 遍历城市时间列表       const timeZoneId: string = cityTime.timeZone.getID(); // 获取时区ID       const calendar = i18n.getCalendar(locale); // 获取日历对象       calendar.setTimeZone(timeZoneId); // 设置日历的时区        // 获取当前时间的各个部分       const year = calendar.get("year").toString().padStart(4, '0'); // 年       const month = calendar.get("month").toString().padStart(2, '0'); // 月       const day = calendar.get("date").toString().padStart(2, '0'); // 日       const hour = calendar.get("hour_of_day").toString().padStart(2, '0'); // 小时       const minute = calendar.get("minute").toString().padStart(2, '0'); // 分钟       const second = calendar.get("second").toString().padStart(2, '0'); // 秒        // 更新城市的当前时间字符串       cityTime.currentTime = `${year}年${month}月${day}日 ${hour}:${minute}:${second}`;     }   }    onPageShow(): void { // 页面显示时的处理     clearInterval(this.updateIntervalId); // 清除之前的定时器     this.updateIntervalId = setInterval(() => { // 设置新的定时器       this.updateAllCityTimes(); // 每秒更新所有城市的时间     }, 1000);   }    onPageHide(): void { // 页面隐藏时的处理     clearInterval(this.updateIntervalId); // 清除定时器   }    private highlightSearchText(cityTime: CityTimeInfo, keyword: string) { // 高亮搜索文本     let text = cityTime.cityName // 获取城市名称      if (!keyword) { // 如果没有关键词       cityTime.isVisible = true // 设置城市可见       return [text] // 返回城市名称     }     let segments: string[] = []; // 存储分段文本     let lastMatchEnd: number = 0; // 上一个匹配结束的位置     while (true) { // 循环查找关键词       const matchIndex = text.indexOf(keyword, lastMatchEnd); // 查找关键词位置       if (matchIndex === -1) { // 如果没有找到         segments.push(text.slice(lastMatchEnd)); // 添加剩余文本         break; // 退出循环       } else {         segments.push(text.slice(lastMatchEnd, matchIndex)); // 添加匹配前的文本         segments.push(text.slice(matchIndex, matchIndex + keyword.length)); // 添加匹配的关键词         lastMatchEnd = matchIndex + keyword.length; // 更新最后匹配结束位置       }     }     cityTime.isVisible = (segments.indexOf(keyword) != -1) // 设置城市可见性     return segments; // 返回分段文本   }    aboutToAppear() { // 组件即将出现时的处理     const timeZoneIds: Array<string> = i18n.TimeZone.getAvailableIDs(); // 获取可用时区ID列表      this.cityTimeList.push(new CityTimeInfo('北京 (中国)', i18n.getTimeZone())); // 添加北京的城市时间信息      for (const id of timeZoneIds) { // 遍历时区ID       const cityDisplayName = i18n.TimeZone.getCityDisplayName(id.split('/')[1], "zh-CN"); // 获取城市显示名称       if (cityDisplayName) { // 如果城市名称存在         this.cityTimeList.push(new CityTimeInfo(cityDisplayName, i18n.getTimeZone(id))); // 添加城市时间信息       }     }      this.updateAllCityTimes(); // 更新所有城市的时间   }    build() { // 构建组件的UI     Column({ space: 0 }) { // 创建一个垂直列       Search({ value: $$this.searchText })// 创建搜索框         .margin(this.basePadding)// 设置边距         .fontFeature(""ss01" on") // 设置字体特性       Column() { // 创建一个列         Row() { // 创建一行           Text('城市')// 显示“城市”文本             .height('100%')// 高度占满             .layoutWeight(this.ratio[0])// 设置布局权重             .textAlign(TextAlign.Center)// 文本居中             .fontSize(this.textSize)// 设置字体大小             .fontWeight(600)// 设置字体粗细             .fontColor(this.textColor) // 设置字体颜色           Line().height('100%').width(this.lineWidth).backgroundColor(this.lineColor) // 创建分隔线           Text('时间')// 显示“时间”文本             .height('100%')// 高度占满             .layoutWeight(this.ratio[1])// 设置布局权重             .textAlign(TextAlign.Center)// 文本居中             .fontSize(this.textSize)// 设置字体大小             .fontWeight(600)// 设置字体粗细             .fontColor(this.textColor) // 设置字体颜色         }.height(this.rowHeight).borderWidth(this.lineWidth).borderColor(this.lineColor) // 设置行高和边框         .backgroundColor(this.titleBackgroundColor) // 设置背景色       }.width(`100%`).padding({ left: this.basePadding, right: this.basePadding }) // 设置列宽和内边距        Scroll() { // 创建可滚动区域         Column() { // 创建一个列           ForEach(this.cityTimeList, (item: CityTimeInfo) => { // 遍历城市时间列表             Row() { // 创建一行               Text() { // 创建文本                 ForEach(this.highlightSearchText(item, this.searchText), (segment: string, index: number) => { // 高亮搜索文本                   ContainerSpan() { // 创建容器                     Span(segment)// 创建文本段                       .fontColor(segment === this.searchText ? Color.White : Color.Black)// 设置字体颜色                       .onClick(() => { // 点击事件                         console.info(`高亮文本被点击：${segment}`); // 输出点击的文本                         console.info(`点击索引：${index}`); // 输出点击的索引                       });                   }.textBackgroundStyle({                     // 设置文本背景样式                     color: segment === this.searchText ? Color.Red : Color.Transparent // 根据是否匹配设置背景色                   });                 });               }               .height('100%') // 高度占满               .layoutWeight(this.ratio[0]) // 设置布局权重               .textAlign(TextAlign.Center) // 文本居中               .fontSize(this.textSize) // 设置字体大小               .fontColor(this.textColor) // 设置字体颜色                Line().height('100%').width(this.lineWidth).backgroundColor(this.lineColor) // 创建分隔线               Text(item.currentTime)// 显示当前时间                 .height('100%')// 高度占满                 .layoutWeight(this.ratio[1])// 设置布局权重                 .textAlign(TextAlign.Center)// 文本居中                 .fontSize(this.textSize)// 设置字体大小                 .fontColor(this.textColor) // 设置字体颜色             }             .height(this.rowHeight) // 设置行高             .borderWidth({ left: this.lineWidth, right: this.lineWidth, bottom: this.lineWidth }) // 设置边框宽度             .borderColor(this.lineColor) // 设置边框颜色             .visibility(item.isVisible ? Visibility.Visible : Visibility.None) // 根据可见性设置显示状态           })          }.width(`100%`).padding({ left: this.basePadding, right: this.basePadding }) // 设置宽度和内边距       }       .width('100%') // 设置宽度占满       .layoutWeight(1) // 设置布局权重       .align(Alignment.Top) // 对齐方式       .onScrollStart(() => { // 滚动开始事件         this.onPageHide() // 页面隐藏处理       })       .onScrollStop(() => { // 滚动停止事件         this.onPageShow() // 页面显示处理       })       .onTouch((event) => { // 触摸事件         if (event.type == TouchType.Down) { // 如果是按下事件           inputMethod.getController().stopInputSession() // 停止输入会话         }       })     }   } }