Skip to content

Date 日期库

dateuts 日期库使用 uts语言 实现了 dayjs 大部分常用的Api。 dateuts 日期库主要用于解析、格式化、操作和显示日期和时间‌。支持链式调用,简单易用。

引入

ts
import { dateuts } from '@/uni_modules/rice-ui';

解析

当前时间

直接调用 dateuts() 将返回一个包含当前日期和时间的Dateuts对象实例。

ts
dateuts()
//对日期进行格式化
dateuts().format('YYYY-MM-DD')

当没有传递参数时,会返回当前的日期和时间,等同于 dateuts(new Date())

字符串

解析传入的ISO 8601 格式的字符串并返回一个 Dateuts对象实例。

ts
dateuts('2025-01-01 12:00:00')
dateuts('2025-01-01 12:00')
dateuts('2025-01-01 12')
dateuts('2025-01-01T12:00')
dateuts('2025/01/01 12:00:00')
dateuts('2025/01/01 12:00')
dateuts('2025/01/01 12')
//...其他更多ISO 8601格式的字符串

注意

不支持传入 2025年01月01日 这种格式的字符串

Unix 时间戳 (毫秒)

解析传入的一个 Unix 时间戳 (13 位数字, 1970 年 1 月 1 日(UTC)起经过的毫秒数) 并返回一个 Dateuts对象实例。

ts
dateuts(1742054345873)

注意

传递的参数必须是一个数字

Date 对象

ts
const d=new Date(2023,2)
const d1 = dateuts(d)

提示

dateuts内部会克隆传入的 Date 对象。dateuts实例的任何操作都不会影响到传入的 Date 对象,反之亦然。
如上,d1对象的任何操作都不会影响到原始的 d 对象