Day.js使用重载的getter和setter,也就是说,调用这些不带参数的方法作为getter,调用带参数的方法作为setter。

它们映射到本地Date对象上的相应函数。

dayjs().second(30).valueOf() // => new Date().setSeconds(30)
dayjs().second() // => new Date().getSeconds()

如果您处于UTC mode,它们将映射到等效的UTC。

dayjs.utc().seconds(30).valueOf()// => new Date().setUTCSeconds(30)
dayjs.utc().seconds()// => new Date().getUTCSeconds()

# 毫秒

获取或设置毫秒。

接受0到999的数字。如果超过这个范围,将持续到秒。

dayjs().millisecond()
dayjs().millisecond(1)

#

获取或设置秒。

接受0到59的数字。如果超过这个范围,将持续到分钟。

dayjs().second()
dayjs().second(1)

# 分钟

获取或设置分钟。

接受0到59的数字。如果超过这个范围,将持续到小时。

dayjs().minute()
dayjs().minute(59)

# 小时

获取或设置小时。

接受0到59的数字。如果超过这个范围,将持续到日。

dayjs().hour()
dayjs().hour(12)

# 日期

获取或设置月份的日期。

接受从1到31的数字。如果超过这个范围,将持续到日。

dayjs().date()
dayjs().date(1)

注意

dayjs#date表示月份的日期,而dayjs#day表示星期的日期。

# 星期

获取或设置星期几。

接受0(星期日)到6(星期六)的数字。如果超过这个范围,将持续到几周。

dayjs().day()
dayjs().day(0)

# ISO星期

获取或设置ISO day of the week,其中1为星期一,7为星期日。

注意

此功能依赖IsoWeek插件

dayjs.extend(isoWeek)

dayjs().isoWeekday()
dayjs().isoWeekday(1); // Monday

# 年-日期

获取或设置一年中的日期。

接受1到366的数字。如果超过了这个范围,将持续到数年。

注意

此功能依赖DayOfYear插件

dayjs.extend(dayOfYear)

dayjs('2010-01-01').dayOfYear() // 1
dayjs('2010-01-01').dayOfYear(365) // 2010-12-31

# 年-星期

获取或设置一年中的星期。

注意

此功能依赖WeekOfYear插件

dayjs.extend(weekOfYear)

dayjs('2018-06-27').week() // 26
dayjs('2018-06-27').week(5) // set week

# 年-星期(ISO)

获取或设置ISO week of the year

注意

此功能依赖IsoWeek插件

dayjs.extend(isoWeek)

dayjs().isoWeek()
dayjs().isoWeek(2)

#

获取或设置月份。

接受0到11的数字。如果超过这个范围,将一直持续到年底。

dayjs().month()
dayjs().month(0)

注意

月份的索引为0,因此January是第0个月。

# 季度

获取或设置季度。

注意

此功能依赖QuarterOfYear插件

dayjs.extend(quarterOfYear)

dayjs('2010-04-01').quarter() // 2
dayjs('2010-04-01').quarter(2)

#

获取或设置年份。

dayjs().year()
dayjs().year(2000)

# 周年

获取本地周年

注意

此功能依赖WeekYear插件

dayjs.extend(weekYear)
dayjs.extend(weekOfYear)

dayjs().weekYear()

# 周年(ISO)

获取ISO week-year

注意

此功能依赖IsoWeek插件

dayjs.extend(isoWeek)

dayjs().isoWeekYear()

# 年周数(ISO)

根据ISO weeks获取当前年度的周数。

注意

此功能依赖IsoWeeksInYear插件

dayjs.extend(isoWeeksInYear)
dayjs.extend(isLeapYear)

dayjs('2004-01-01').isoWeeksInYear() // 53
dayjs('2005-01-01').isoWeeksInYear() // 52

# 获取

字符串getter,返回从Day.js对象中获取的相应信息。

语法:

dayjs().get(unit) === dayjs()[unit]()

单位不区分大小写,支持复数和缩写形式。

dayjs().get('year')
dayjs().get('month') // start 0
dayjs().get('date')
dayjs().get('hour')
dayjs().get('minute');
dayjs().get('second');
dayjs().get('millisecond');

所有可用单位列表

单位 缩写 描述
date D 日期
day d 星期(星期日0,星期六6)
month M 月份(0-11)
year y
hour h 小时
minute m 分钟
second s
millisecond ms 毫秒

# 设置

泛型setter接受unit作为第一个参数,value作为第二个参数,返回一个带有更改的新实例。

语法:

dayjs().set(unit, value) === dayjs()[unit](value)

单位不区分大小写,支持复数和缩写形式。

dayjs().set('date', 1)
dayjs().set('month', 3) // April
dayjs().set('second', 30)

# 最大值

返回给定Day.js实例的最大值。

注意

此功能依赖MinMax插件

dayjs.extend(minMax)

dayjs.max(dayjs(), dayjs('2018-01-01'), dayjs('2019-01-01'))

# 最小值

返回给定Day.js实例的最小值。

注意

此功能依赖MinMax插件

dayjs.extend(minMax)

dayjs.min([dayjs(), dayjs('2018-01-01'), dayjs('2019-01-01')])
Last Updated: 1/19/2021, 11:00:24 PM