com.x52im.rainbowchat.http.logic.dto

类 TimeToolKit

java.lang.Object

com.x52im.rainbowchat.http.logic.dto.TimeToolKit

public class TimeToolKit
extends java.lang.Object

时间显示工具类。本类可用于标准Java和Andriod平台中。

从以下版本开始:

7.1

构造器概要

构造器

构造器和说明
TimeToolKit()

方法概要

限定符和类型	方法和说明
static java.lang.String	convertTimstampToDefaultTimeZone(java.lang.String timestampWithGMT, java.lang.String timePattern) 不带时区信息的时间戳按当前默认时代转换成时间字串显示。
static java.util.Date	getDateTime(long timestampWithGMT)
static java.util.Date	getDateTime(java.lang.String timestampWithGMT) 将指定字符串时间戳转为Date对象。
static java.lang.String	getMMSSFromSS(int durationWithSecond) 传入秒数，得到“mm:ss”样的字符串。
static java.lang.String	getTimeString(java.util.Date dt, java.lang.String pattern) 返回指定pattern样的日期时间字符串。
static java.lang.String	getTimeStringAutoShort(java.util.Date srcDate) 已过时。 by OfflineMsgDTO#getTimeStringAutoShort2(Date, boolean), @since 4.5
static java.lang.String	getTimeStringAutoShort2(java.util.Date srcDate, boolean mustIncludeTime, boolean timeWithSegmentStr) 仿照微信中的消息时间显示逻辑，将时间戳（单位：毫秒）转换为友好的显示格式.
static void	main(java.lang.String[] args)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

TimeToolKit

public TimeToolKit()

方法详细资料

getMMSSFromSS

public static java.lang.String getMMSSFromSS(int durationWithSecond)

传入秒数，得到“mm:ss”样的字符串。 目前主要用于Andriod端显示短视频的视频时长时使用，本方法也可用于任何标准Java的代码中。

参数:

durationWithSecond - 秒数

返回:

形如“0:10”这样的字符串，表示10秒时长的短视频

从以下版本开始:

7.1

convertTimstampToDefaultTimeZone

public static java.lang.String convertTimstampToDefaultTimeZone(java.lang.String timestampWithGMT,
                                                                java.lang.String timePattern)

不带时区信息的时间戳按当前默认时代转换成时间字串显示。

参数:

timestampWithGMT - 本时间戳为GMT标准时间，解决跨国跨时区问题，用于UI时客户端需要转换成自已 的时区后再使用哦，此字段存放的是java版无时间时间戳，形如：1510491984536）

timePattern - 要转换的目标时间字串格式

返回:

如果转换成功则返回指定样式的时间字串，否则返回""

getTimeString

public static java.lang.String getTimeString(java.util.Date dt,
                                             java.lang.String pattern)

返回指定pattern样的日期时间字符串。

参数:

dt -

pattern -

返回:

如果时间转换成功则返回结果，否则返回空字符串""

getDateTime

public static java.util.Date getDateTime(java.lang.String timestampWithGMT)

将指定字符串时间戳转为Date对象。

参数:

timestampWithGMT - 本时间戳为GMT标准时间，解决跨国跨时区问题，用于UI时客户端需要转换成自已 的时区后再使用哦，此字段存放的是java版无时间时间戳，形如：1510491984536）

返回:

getDateTime

public static java.util.Date getDateTime(long timestampWithGMT)

getTimeStringAutoShort

public static java.lang.String getTimeStringAutoShort(java.util.Date srcDate)

已过时。 by OfflineMsgDTO#getTimeStringAutoShort2(Date, boolean), @since 4.5

显示一个人性化的时间字串（本方法当前主要用于客户界面的消息时间显示时）。

当此时间是当天时间则显示“时分”格式，如果是当年则显示“月时分”格式，如果是 今年之前的则显示为“年月时分”格式。

本方法当前主要用于Android客户端首页“消息界面”中显示离线消息的时间之用，目 的是让时间显示尽可能短且人性化，仅此而已。

参数:

dt - NSDate对象

返回:

如果转换成功则返回形如：“刚刚”、“12:01"、“03-01 12：01”、“2018-02-01 12：01”，否则返回""

getTimeStringAutoShort2

public static java.lang.String getTimeStringAutoShort2(java.util.Date srcDate,
                                                       boolean mustIncludeTime,
                                                       boolean timeWithSegmentStr)

仿照微信中的消息时间显示逻辑，将时间戳（单位：毫秒）转换为友好的显示格式.

1）7天之内的日期显示逻辑是：今天(具体的“时间:分钟”样式)、昨天(-1d)、前天(-2d)、星期？（只显示总计7天之内的星期数，即<=-4d）；
2）7天之外（即>7天）的逻辑：当年(显示“M月/d日”)、去年及之前(显示“yy年/M月/d日”)。

参数:

srcDate - 要处理的源日期时间对象

mustIncludeTime - true表示输出的格式里一定会包含“时间:分钟”（如果是“当天”，则不受此参数控制，无条件包含时间分钟），否则不包含（参考微信，不包含时分的情况，用于首页“消息”中显示时）

timeWithSegmentStr - 本参数仅在mustIncludeTime=true时有生效，表示在时间字符串前带上“上午”、“下午”、“晚上”这样的描述

返回:

输出格式形如：“上午10:30”、“昨天 中午12:04”、“前天 晚上20:51”、“星期二 上午09:30”、“5月6日 上午11:09”、“20年5月6日 上午11:09”等形式

从以下版本开始:

4.5

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

抛出:

java.lang.Exception