kwgt 时间与日期函数 tc tf df 全家桶

三类时间函数

tc（Time Current）——实时当前时间

tc 返回当前时间的各种片段，每秒刷新一次：

df（Date Format）——日期格式化

df 把日期按照你指定的格式字符串格式化：

$df(格式字符串)$

常用格式：

组合示例：

$df(dd MMM, EEEE)$ → "15 Oct, Wednesday"

tf（Time From）——时间间隔

tf 计算从某个时间点到现在过了多久：

$tf(时间戳, 'dd天 HH:mm')$

常用于：倒计时、发布了多久、电池上次充电到现在多久。

时区处理

kwgt 默认用系统时区。想显示其他时区的时间：

$tc(tz='Asia/Tokyo', hz)$

或者用 df 的时区参数：

$df('HH:mm', tz='America/New_York')$

刷新频率

• tc 函数默认每秒刷新（精确到毫秒）
• df 函数默认每分钟刷新（日期不需要每秒变）
• 如果在同一个文字里混用 tc 和 df，刷新频率会以 tc 为准（最频繁的那个）

实战：12 小时制动态时钟

$tc(h12)$$tc(mz)$ $tc(ampm)$

输出像 342 PM（秒显示没加冒号），想加冒号：

$tc(h12)$:$tc(mz)$ $tc(ampm)$

这样就是 3:42 PM 的效果了。