date 日期时间库

date 日期时间库

AI 原文

date 日期时间库

功能

date() 创建本地时区 Date 对象；支持日期字符串解析、chrono/strftime 风格格式化、Unix 时间戳转换、日期运算，以及年月日时分秒等字段读取。

语法

参数

参数类型必填默认值说明
timestampInt/Float否无秒级 Unix 时间戳；不传任何参数时返回当前本地时间。
textString否无日期字符串或秒级 Unix 时间戳字符串。

返回值

类型说明
Date返回本地时区 Date 对象。

API 列表

API说明
Date.format按格式字符串输出日期时间。
Date.from_string解析日期字符串并创建新的 Date 对象。
Date.from_timestamp通过秒级 Unix 时间戳创建新的 Date 对象。
Date.from_millis通过毫秒级 Unix 时间戳创建新的 Date 对象。
Date.from_micros通过微秒级 Unix 时间戳创建新的 Date 对象。
Date.from_nanos通过纳秒级 Unix 时间戳创建新的 Date 对象。
Date.add返回加减指定时间后的新 Date 对象。
Date.diff返回两个日期之间按指定单位换算后的差值。
Date.start_of_day返回当天零点的新 Date 对象。
Date.timestamp读取秒级 Unix 时间戳。
Date.timestamp_millis读取毫秒级 Unix 时间戳。
Date.timestamp_micros读取微秒级 Unix 时间戳。
Date.timestamp_nanos读取纳秒级 Unix 时间戳。
Date.year读取年份。
Date.month读取月份。
Date.day读取月份中的日期。
Date.hour读取小时。
Date.minute读取分钟。
Date.second读取秒。
Date.millis读取当前秒内的毫秒部分。
Date.micros读取当前秒内的微秒部分。
Date.nanos读取当前秒内的纳秒部分。
Date.weekday读取星期序号。
Date.week读取 ISO 周序号。
Date.yearday读取一年中的日期序号。
Date.quarter读取季度。
Date.to_string按默认格式输出日期时间。

代码示例

注意事项

  • 无参数 date() 返回当前本地时间。
  • 整数和浮点参数按秒级 Unix 时间戳创建 Date。
  • 字符串参数会按常见日期格式解析为 Date，不再支持 date('%Y-%m-%d') 直接格式化当前时间。
  • 格式化当前时间请使用 date().format('%Y-%m-%d')。
  • Date 内部使用本地时区，遇到夏令时歧义时间时使用第一个本地时间结果。