现实时间工具

​ 现实时间工具可以获取和处理现实时间，包含获取时间戳、获取显示时间、计算时间差、获取周几、获取周首日、获取月份头等功能。

名称	现实时间工具
包路径	util2.basic.realtime
开发者	kunjinkao_xs

class RealTimeUtil

• 基类：object
• 保存和处理显示时间的工具

构造函数

RealTimeUtil(*itime):

• 参数：元组
  • 单参数时：
    • int | float | long - 以Unix时间戳设置
    • datetime - 以datetime对象设置
    • basestring - 以显示时间设置，且为默认格式%Y/%m/%d %H:%M:%S
    • timedelta - 设为当前时间加上timedelta
  • 双参数时：
    • str, str - 以首个参数作为显示时间设置，且指定格式为第二个参数
  • 多参数时：直接传递给datetime构造函数

方法

getDateTime()

• 获取设置的datetime
• 返回：datetime - 构造时设置时间的datetime对象

getTimeStamp()

• 获取设置时间的Unix时间戳
• 返回：float - 精确到毫秒的浮点数时间戳，其整数部分为秒

getIntTimeStamp()

• 获取设置时间的Unix时间戳
• 返回：int - 整数Unix时间戳

getDisplayTime(format='%Y/%m/%d')

• 参数：
  • format: str - 时间格式，默认值%Y/%m/%d %H:%M:%S
• 获取设置时间的显示时间，且按输入或默认格式显示
• 返回：str - 显示时间

addTimeDelta(delta)

• 参数：
  • delta: timedelta - 要增加的timedelta
• 在设置时间上加

calTimeDifference(timeUtil)

• 参数：
  • timeUtil: RealTimeUtil | datetime - 到时
• 计算设置时间到到时的时间差
• 返回：timedelta - 时间差

calSecondsDifference(timeUtil)

• 参数：
  • timeUtil: RealTimeUtil | datetime - 到时
• 计算秒时间差
• 返回：float - 秒时间差

getWeekday()

• 获取本日为周几
• 返回 - 以0-6代表周几

isWeekday(*days)

• 参数：
  • *days: tuple[int] - 范围，以0-6代表周几
• 判断本日是否为days指定的周几范围
• 返回：bool

getMondayHeader(format='%Y/%m/%d')

• 参数：
  • format: str - 时间格式，默认值%Y/%m/%d
• 获取周一显示时间，可作为存储周信息的索引
• 返回：str - 显示时间

getMonthHeader(format='%Y/%m')

• 参数：
  • format: str - 时间格式，默认值%Y/%m
• 获取月显示时间（月份头），可作为存储月信息的索引
• 返回：str - 显示时间

getPreviousMonthHeader(months, format="%Y/%m")

• 参数：
  • months: int - 月份数
  • format: str - 时间格式，默认值%Y/%m
• 获取前months个月的月显示时间（月份头），可作为检索月信息的索引
• 返回：tuple[str] - 元素为月份头的元组

def isValidStrTime(dateString, format='%Y/%m/%d %H:%M:%S')

• 参数：
  • dateString: str - 日期字符串
  • format: str - 时间格式，默认为%Y/%m/%d %H:%M:%S
• 输入的内容是否可以按照时间格式转为时间，可用于判断玩家AnvilInputer输入的合法性
• 返回：bool - 是否可以转为时间