鸿蒙开源第三方组件——日期和时间处理组件JodaTime-ohos-低调大师

鸿蒙开源第三方组件——日期和时间处理组件JodaTime-ohos

2021-06-24 797

前言

基于安卓平台的日期和时间处理组件JodaTime-ohos（https://github.com/dlew/joda-time-android），实现鸿蒙化迁移和重构。代码已经开源到（https://gitee.com/isrc_ohos/joda-time_ohos），欢迎各位下载使用并提出宝贵意见！

背景

JodaTime-ohos是一个日期和时间处理组件，可以获取标准时间、当前时间、相对时间、格式化时间等多种形式的时间，并支持对各类时间进行计算和判断。该组件易于使用、可扩展性强、拥有全面的功能集，支持多种日历系统，被广泛应用于时间显示类应用。

组件效果展示

（1）显示“标准时间”“一段时间”“格式化时间”“一段时间的相对表示”“一段时间的相对的字符串表示”“相对时间”

标准时间：程序执行时刻的时间表示，见图1中的a。
格式化时间：将日期/时间格式转换为预先定义的日期/时间格式，见图1中的b。
一段时间：在程序执行时刻的基础上，增加一段时间后的起始时间和结果时间显示，见图1中的c。
一段时间的相对表示：未来或者在过去的某个时间段表示，见图1中的d。
一段时间的相对字符串表示：在程序执行时刻的基础上，增加一段时间的结果时间显示，见图1中的e。
相对时间：在程序执行时刻的基础上，增加一段时间后的结果时间和时间段表示，见图1中的f。

图1 显示“标准时间”“一段时间”“格式化时间”“一段时间的相对表示”“一段时间的相对的字符串表示”“相对时间”

（2）显示“当前时间”、“是否为今天”

当前时间：程序执行时刻的年月日表示。同时也可以给出在当前时间的基础上增加一段时间后的结果表示，如图2的a所示。
是否为今天：可以判断程序执行的日期是否为今天、是否为昨天、是否为明天，如图2的b所示。

图2 显示“当前时间”、“是否为今天”

（3）显示“一段时间的格式化表示”

“一段时间的格式化表示”：将一段时间用对应的单位表示出来。

图3 显示“一段时间的格式化表示”

Sample解析

1、工程结构

图4 Sample的工程结构

从上图可以看出，Sample的工程结构主要分为三个部分：图中第①部分的MainAbilitySlice主要负责构建组件应用的主页面布局。主页面上有9个按钮，点击不同的按钮，会跳转到不同的导航界面，每个界面显示不同的时间格式，如图5所示。

图5 组件应用的主页面布局

图中第②部分的内容包含多个AbilitySlice，每一个AbilitySlice都对应①中的一个导航界面。界面中会包含特定格式的时间显示，如图6所示。

图6 按钮导航界面

图中第③部分内容包含两个文件：MainAbility是一切应用的入口，通过setMainRoute()设置路由，将组件应用的主界面设置为MainAbilitySlice。JodaTime则是为了创建示例接收时区变换的广播。

// JodaTime
try {
    JodaTimeAndroid.init(this); //init方法用于创建示例接收时区变换的广播
} catch (RemoteException e) {
    e.printStackTrace();
}

2、时间的获取

JodaTime-ohos可以为开发者提供9种不同格式的时间，下面我们以sampleGetRelativeTimeSpanStringslice为例，展示“一段时间的相对表示”时间的获取，效果如上述图1中的d所示。其余几种时间格式的使用方法同理，不再赘述。

1、导入相关类

在sampleGetRelativeTimeSpanStringslice导入DateTime类，并得到实例化对象，该类是时间日期获取工具类。

//导入相关类DateTime
import org.joda.time.DateTime;
......
//实例化类对象
DateTime now = DateTime.now();

2、设置时间显示布局

在sampleGetRelativeTimeSpanStringslice中创建一个DirectionalLayout布局，用于显示获取到的时间。

DirectionalLayout directionalLayout = new DirectionalLayout(this);
......
@Override
protected void onStart(Intent intent) {
    super.onStart(intent);
    //设置Layout的宽和高
    directionalLayout.setWidth(ComponentContainer.LayoutConfig.MATCH_PARENT);
	directionalLayout.setHeight(ComponentContainer.LayoutConfig.MATCH_PARENT);
    directionalLayout.setPadding(32, 32, 80, 80); //设置Layout填充距离
    ShapeElement element = new ShapeElement();
    element.setRgbColor(new RgbColor(255, 255, 255));
    directionalLayout.setBackground(element); //设置Layout背景
    ......
}

3、设置时间显示控件

由于需要在布局中显示多个时间结果，所以此处创建一个List，内部元素为String类型，每个String元素表示一个时间结果。

List<String> text = new ArrayList<String>();

4、获取日期和时间值

通过上述创建的DateTime 类对象，分别调用类中不同的方法如plusMinutes()、minusMinutes()，在起始时间点的基础上增加或减少一个固定的时间；后使用DateUtils类的getRelativeTimeSpanString()方法将获得到日期和时间值以对应的单位（时、分或秒）表示出来。

text.add("Short future: " + DateUtils.getRelativeTimeSpanString(this, now.plusMinutes(25)));//目前时间值基础上增加分钟数
text.add("Medium future: " + DateUtils.getRelativeTimeSpanString(this, now.plusHours(5)));//目前时间值基础上增加小时数
text.add("Long future: " + DateUtils.getRelativeTimeSpanString(this, now.plusDays(3)));//目前时间值基础上增加天数
text.add("Short past: " + DateUtils.getRelativeTimeSpanString(this, now.minusMinutes(25)));//目前时间值基础上减少分钟数
text.add("Medium past: " + DateUtils.getRelativeTimeSpanString(this, now.minusHours(5)));//目前时间值基础上减少小时数
text.add("Long past: " + DateUtils.getRelativeTimeSpanString(this, now.minusDays(3)));//目前时间值基础上减少天数

5、添加控件到布局中

将获取到的日期和时间值添加到时间显示布局DirectionalLayout中。

directionalLayout.addComponent(textT);

3、日期和时间常用类

第2小节的例子通过DateTime来获取时间，通常情况下，在使用JodaTime_ohos组件的过程中，使用最多的日期时间获取类共有5种，分别是：Instant类、DateTime类、LocalDate类、LocalTime类和LocalDateTime类。根据要获取日期和时间值的格式不同，需要引入的类也会有所差别，以下分别对这几个类的功能做简单介绍：

Instant：用来表示时间轴上一个瞬时的点，即一个事件发生的时间戳，可以忽略其使用的日历系统或所在时区。

DateTime类：是JodaTime_ohos的核心类，能够确定在时间轴上的位置。使用此类的时间格式有标准时间（sampleDateTimeslice）、格式化时间（sampleFormatDateTimeslice）、一段时间间隔（sampleDateRangeslice）、相对时间（sampleGetRelativeDateTimeStringslice）、一段时间的相对表示（sampleGetRelativeTimeSpanStringslice）、一段相对时间的字符串表示（sampleGetRelativeTimeSpanStringWithPrepositionslice）。
LocalDate类：表示本地的日期，不包含时间部分，因此适合强调日期的情况如纪念日。使用此类的时间格式有当前时间（sampleLocalDateslice）、今日时间（sampleIsTodayslice）。
LocalTime：表示本地的时间，不包含日期部分，因此适合强调时间的情况如上下班时间。
LocalDateTime：表示本地的日期和时间，因此适用于同时强调日期和时间的情况，如考试时间。

上述五个类都是不可变的类，不论怎样对它进行修改和处理，所有日期和时间相关操作的 API 都将返回一个全新的JodaTime_ohos 实例，类似Java的String类。除了上述5种常用类，本Sample中还使用到了Duration类，涉及到此类的时间格式是一段时间的格式化表示（sampleFormatDurationslice）。

Library解析

JodaTime-ohos组件的整个library分为五个部分，如图7所示。

图7 library组成结构

JodaTimeAndroid类负责初始化相关操作，在开始使用JodaTime_ohos组件之前，都需要通过此类的init()方法进行初始化操作，否则将不能正常访问组件中的类和方法；
ResourceZoneInfoProvide类负责监控时区变化，但是此处需要注意的是，鸿蒙里没有提示时区变化的intent；
TimeZoneChangedReceiver类则负责处理监控到的时区变化；
DateUtils类主要负责将获取到的日期和时间值进行处理得到多种格式。

其中，DateUtils类是最核心的时间格式处理类，是经过封装的工具类。如图8所示，在Sample中使用到的日期和时间类是DateTime类、LocalDate类和Duration类，共三种，在通过DateUtils类中相应方法将获取到日期和时间值进行处理之后，可以得到多达7种格式的日期和时间表现形式。

图8 时间格式处理核心类

1、方法重载实现多时间格式

在DateUtils类中，包含很多时间格式转换的方法，其中有些方法通过方法重载存在多种参数形式，在使用时可以根据需求传入不同个数的参数，从而得到不同格式的日期和时间，增加了程序的可读性。

以getRelativeTimeSpanString()方法为例，此方法用于获得相对时间的跨度，如“20分钟前”、“20分钟内”。通过方法重载的方式，调用此方法根据参数的不同能够得到两种，分别有两个参数和三个参数两种形式：

（1）两个参数

当传入参数分别是time和flags时，得到的时间格式是一段时间的相对表示，效果如上述图1.1中的d图所示。在获取到传入的原始时间值之后，进行时、分、秒的判断，从而完成相应的处理。

public static CharSequence getRelativeTimeSpanString(Context context, ReadableInstant time, int flags) throws NotExistException, WrongTypeException, IOException {
        boolean abbrevRelative = (flags & (FORMAT_ABBREV_RELATIVE | FORMAT_ABBREV_ALL)) != 0;
   //将传入的原始时间值转换为DateTime类型
        DateTime now = DateTime.now(time.getZone()).withMillisOfSecond(0);
        //获取原始时间值   
   DateTime timeDt = new DateTime(time).withMillisOfSecond(0);
        boolean past = !now.isBefore(timeDt);
        Interval interval = past ? new Interval(timeDt, now) : new Interval(now, timeDt);
        ...
        //进行时、分、秒的判断，完成相应处理
        if (Minutes.minutesIn(interval).isLessThan(Minutes.ONE)) {...}
        else if (Hours.hoursIn(interval).isLessThan(Hours.ONE)) {...}
        else if (Days.daysIn(interval).isLessThan(Days.ONE)) {...}
        else if (Weeks.weeksIn(interval).isLessThan(Weeks.ONE)) {...}
        ...
        return String.format(format, count);//返回处理结果
}

（2）三个参数：

当传入参数分别是time、flags和withPrepositon时，得到的时间格式是一段相对时间的字符串表示，效果如上述图1.1中的e图所示。先获取传入的原始时间值，将其转换为LocalDate格式，之后分别针对时、分、秒进行判断，从而完成处理返回相应的时间格式。

public static CharSequence getRelativeTimeSpanString(Context ctx, ReadableInstant time, boolean withPreposition) throws NotExistException, WrongTypeException, IOException {
    String result;
    LocalDate now = LocalDate.now();//实例化LocalDate对象，获取本地时间
    LocalDate timeDate = new LocalDate(time);//将传入的原始时间值转换为LocalDate类型
    int prepositionId;
    //针对时、分、秒进行判断，完成处理
    if (Days.daysBetween(now, timeDate).getDays() == 0) {...}
    else if (Years.yearsBetween(now, timeDate).getYears() != 0) {...}
    else {...}
    if (withPreposition) {
        result = ctx.getResourceManager().getElement(prepositionId).getString(result);
    }
    return result;//返回处理结果
}

2、同方法中通过判断实现多时间格式

除了上述通过方法重载实现不同时间格式的情况，DateUtils类中还有另一种实现多时间格式的方式，即在同一个方法中，通过判断不同类型的原始时间数据进行相应的处理，从而得到不同类型的时间值。

以一段时间的格式化表示的sampleFormatDurationslice类为例，效果如上述图1.4。开发者在Sample中使用的时候，在分别通过standardSeconds()、standardMinutes()、standardHours()方法按需获取不同时间值即秒、分钟、小时之后，再调用DateUtils中的formatDuration()方法：

text.add("Seconds: " + DateUtils.formatDuration(this, Duration.standardSeconds(25)));//获取25秒的标准时间值
text.add("Minutes: " + DateUtils.formatDuration(this, Duration.standardMinutes(5)));//获取5分钟的标准时间值
text.add("Hours: " + DateUtils.formatDuration(this, Duration.standardHours(3)));//获取3小时的标准时间值

在formatDuration()方法中，若原始时间数据包含小时，则进行第一个判断，返回小时类型的时间处理结果；若原始时间数据包含分钟，则进行第二个判断，返回分钟类型的时间处理结果；若原始时间数据包含秒，则不进入判断直接返回秒类型的时间处理结果。

public static CharSequence formatDuration(Context context, ReadableDuration readableDuration) throws IOException, NotExistException, WrongTypeException {
    ResourceManager res = context.getResourceManager();
    Duration duration = readableDuration.toDuration();//将传入的原始时间值转换为Duration类型
    final int hours = (int) duration.getStandardHours();//获取传入的原始时间值
    if (hours != 0) {//判断传入时间值中是否包含小时
        return //返回时间值包含小时的时间格式res.getElement(net.danlew.android.joda.ResourceTable.Plural_joda_time_android_duration_hours).getPluralString(hours, hours);
    }
    final int minutes = (int) duration.getStandardMinutes();
    if (minutes != 0) {//判断传入时间值中是否包含分钟
        return //返回时间值包含分钟的时间格式res.getElement(net.danlew.android.joda.ResourceTable.Plural_joda_time_android_duration_minutes).getPluralString(minutes, minutes);
    }
    final int seconds = (int) duration.getStandardSeconds();
    return //传入时间值中包含秒则直接返回处理后的结果res.getElement(net.danlew.android.joda.ResourceTable.Plural_joda_time_android_duration_seconds).getPluralString(seconds, seconds);
}

项目贡献人

陈丛笑郑森文朱伟陈美汝李珂

想了解更多关于鸿蒙的内容，请访问：

51CTO和华为官方战略合作共建的鸿蒙技术社区

https://harmonyos.51cto.com/#bkwz

微信关注我们

原文链接：https://blog.51cto.com/harmonyos/2945342

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

掌握Linux这30个常用指令，帮你解决95%以上的问题

2 --> Linux中许多常用命令是必须掌握的，这里将分享linux入门时常用的基本命令，希望对你们的学习有所帮助！！！开始之前，分享给大家Linux的视频讲解，小白也可视频观看~ 视频中先从基础讲解Linux的来龙去脉，企业常用的Linux系统CentOS的安装，配置。 Linux十大种类命令的逐一讲解和示例。结合JAVA开发的Web应用。在Linux搭建Web应用运行环境:JDK,MySQL,Tomcat在Linux的安装、配置、日志查看等。以war形式部署Web应用。视频学习完能够满足在企业的实战要求。在线观看：https://www.bilibili.com/video/BV1Li4y1V7pG 资料下载：http://www.bjpowernode.com/javavideo/132.html 文件目录指令 pwd指令基本语法：pwd 用于显示当前目录的路径实操案例： ls指令基本语法: ls [选项] [目录或是文件] 常用选项 -a ：显示当前目录所有的文件和目录，包括隐藏的。 -l ：以列表的方式显示信息，相当于ll 实操案例：列出当前目录下所有的文件...

2021-06-24

626

2 --> 上一个游戏已经告诉大家如何写多个游戏，现在继续写这个无聊的游戏希望大家在看这篇文章之前先看 win10 uwp 商业游戏，在这个文章告诉了大家如何创建游戏。修改数值可以从上一篇的博客的游戏看到升级太简单，所以需要在点击升级点击的时候，下次升级需要的添加写法很简单，请看下面 public class HisjfnnzSqsbtuuqq : DexqurhctSjyfozae, IKdgvtziaSfs { public HisjfnnzSqsbtuuqq(IDfeppzyTmofs dfeppzy) { Dfeppzy = dfeppzy; HnukhltvKfdrpokjz = "点击添加修为"; DmyikbmfDeb = 10; DklvubnuiTeqch = 1; } public IDfeppzyTmofs Dfeppzy { get; } public override void DqqTsb() { DmyikbmfDeb *= 1.5; DklvubnuiTeqch += 1; } public void DdwTynktxyx() { Dfeppz...

2021-06-24

535

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能，例如代码缩略图，Python的插件，代码段等。还可自定义键绑定，菜单和工具栏。Sublime Text 的主要功能包括：拼写检查，书签，完整的 Python API ， Goto 功能，即时项目切换，多选择，多窗口等等。Sublime Text 是一个跨平台的编辑器，同时支持Windows、Linux、Mac OS X等操作系统。