aardio实现中文时间日期格式化的完整方案

1. aardio时间日期转换中文时间实现方案

在Windows平台自动化开发中，时间日期的格式化输出是个高频需求。aardio作为专为Windows自动化设计的脚本语言，其时间日期处理能力直接影响开发效率。今天我们就来深入探讨如何用aardio实现符合中文习惯的时间日期显示。

1.1 基础时间函数解析

aardio内置的时间处理主要依赖两个核心函数：

aardio复制// 获取当前时间
var now = time.now()

// 格式化输出
var str = time.format(now,"%Y-%m-%d %H:%M:%S") 

这里的格式化符号与C语言的strftime保持一致：

• %Y 四位年份
• %m 两位月份
• %d 两位日期
• %H 24小时制小时
• %M 分钟
• %S 秒数

注意：aardio的time模块实际是调用Windows API实现的，其底层性能优于很多脚本语言的日期处理库。

1.2 中文特色格式化实现

要实现"2023年08月15日 14时30分"这样的格式，需要组合使用格式化符号：

aardio复制var chineseTime = time.format(now,"%Y年%m月%d日 %H时%M分")

更符合中文阅读习惯的写法还可以包括：

• 星期几（%A会显示英文，需自定义）
• 上午/下午标识
• 农历日期（需额外计算）

1.3 星期几的中文显示方案

aardio原生不支持中文星期显示，我们可以通过数组映射实现：

aardio复制var weekdays = {"日","一","二","三","四","五","六"}
var weekday = time.format(now,"%w") // 获取星期数字
var chineseWeek = "星期" + weekdays[tonumber(weekday)+1]

var fullTime = time.format(now,"%Y年%m月%d日") + " " + chineseWeek

1.4 12小时制与时段标识

中文常用"上午/下午"的12小时制表示法：

aardio复制var hour = tonumber(time.format(now,"%H"))
var period = hour < 12 ? "上午" : "下午"
hour = hour % 12
hour = hour == 0 ? 12 : hour

var chineseTime12 = string.format("%s%d时%M分", period, hour, time.format(now,"%M"))

2. 高级时间处理技巧

2.1 带农历的完整日期显示

实现农历需要借助第三方库或算法。这里推荐使用aardio社区开源的lunar库：

aardio复制import lunar
var lunarDate = lunar.getLunarDate(now)

var fullChineseDate = string.format(
    "公历：%s 农历：%s年%s%s",
    time.format(now,"%Y年%m月%d日"),
    lunarDate.lunarYearCn,
    lunarDate.lunarMonthCn,
    lunarDate.lunarDayCn
)

2.2 时间差的人性化显示

中文环境下常需要"3天前"、"1小时前"这样的相对时间：

aardio复制function getTimeDiff(t) {
    var diff = time.now() - t
    if(diff < 60) return "刚刚"
    if(diff < 3600) return math.floor(diff/60) + "分钟前"
    if(diff < 86400) return math.floor(diff/3600) + "小时前"
    if(diff < 2592000) return math.floor(diff/86400) + "天前"
    return time.format(t,"%Y-%m-%d")
}

2.3 节假日判断逻辑

结合农历日期可以实现中国传统节日判断：

aardio复制function isFestival(t) {
    var lunar = lunar.getLunarDate(t)
    if(lunar.lunarMonth == 1 && lunar.lunarDay == 1) return "春节"
    if(lunar.lunarMonth == 5 && lunar.lunarDay == 5) return "端午节"
    // 其他节日判断...
    return false
}

3. aardio UI中的时间显示实践

3.1 静态控件时间显示

在窗体设计中实时显示时间：

aardio复制import win.ui
var winform = win.form(text="时间显示示例")

winform.add(
    static={ text=time.format(time.now(),"%Y年%m月%d日 %H时%M分"); bottom=50; right=300; left=50; top=20 }
)

// 定时刷新
winform.setInterval(1000, function() {
    winform.static.text = time.format(time.now(),"%Y年%m月%d日 %H时%M分")
})

winform.show()
win.loopMessage()

3.2 动态时间选择控件

使用datetime控件获取中文格式时间：

aardio复制var datePicker = winform.add(
    datetime={ bottom=100; right=300; left=50; top=70; format="yyyy年MM月dd日 HH时mm分" }
)

winform.button.oncommand = function() {
    var selected = time.format(datePicker.datetime,"%Y年%m月%d日 %H时%M分")
    winform.msgbox(selected)
}

3.3 时间轴UI组件开发

结合aardio的GDIPlus绘图能力，可以制作中文风格时间轴：

aardio复制import gdiplus
var graphics = gdiplus.graphics(winform)

function drawTimeline(startTime, endTime) {
    // 绘制时间轴线
    graphics.drawLine(50, 150, 300, 150, 0x888888)
    
    // 标注中文时间点
    var time1 = time.format(startTime,"%m月%d日")
    graphics.drawString(time1, 50, 160)
    
    var time2 = time.format(endTime,"%m月%d日")
    graphics.drawString(time2, 250, 160)
}

4. 常见问题与优化建议

4.1 性能优化方案

频繁的时间格式化操作可能影响性能，建议：

1. 对于静态显示，缓存格式化结果
2. 使用局部变量存储time.now()结果
3. 复杂计算（如农历）采用延迟加载

aardio复制// 优化示例
var lastTime = ""
function getCachedTime() {
    var now = time.now()
    if(time.format(now,"%H%M") != lastTime) {
        lastTime = time.format(now,"%H时%M分")
    }
    return lastTime
}

4.2 时区处理注意事项

处理跨时区应用时需特别注意：

aardio复制// 获取UTC时间
var utc = time.gmtime(time.now())

// 转换为北京时间（UTC+8）
var beijingTime = time.localtime(time.now() + 8*3600)

4.3 多语言支持方案

通过配置文件实现多语言时间显示：

aardio复制var timeFormats = {
    zh = "%Y年%m月%d日 %H时%M分",
    en = "%m/%d/%Y %I:%M %p"
}

function formatTime(t, lang) {
    return time.format(t, timeFormats[lang] || timeFormats.zh)
}

4.4 数据库时间处理

与数据库交互时的时间格式转换：

aardio复制// SQLite时间存储与读取
var db = sqlite("/data.db")
db.exec("CREATE TABLE IF NOT EXISTS records(time TEXT)")

// 存储标准化时间
db.exec("INSERT INTO records VALUES(?)", time.format(time.now(),"%Y-%m-%d %H:%M:%S"))

// 读取后转为中文格式
var rows = db.getTable("SELECT time FROM records")
for i, row in pairs(rows) {
    row.time = time.format(time.parse(row.time), "%Y年%m月%d日")
}

在实际项目中，我发现合理封装时间处理函数能显著提高开发效率。建议将常用时间操作封装成模块：

aardio复制// mytime.aardio
module mytime {
    formatChinese = function(t) {
        return time.format(t,"%Y年%m月%d日 %H时%M分")
    }
    
    getWeekday = function(t) {
        var weekdays = {"日","一","二","三","四","五","六"}
        return "星期" + weekdays[tonumber(time.format(t,"%w"))+1]
    }
}

// 使用示例
import mytime
var now = time.now()
winform.static.text = mytime.formatChinese(now) + " " + mytime.getWeekday(now)