跳到主要内容

useNow

分类
导出大小
676 B
上次更改
3 个月前

响应式的当前日期实例。

演示

现在:2025年10月23日 周四 06:49:06 GMT+0000 (协调世界时)

用法

ts
import { 
useNow
} from '@vueuse/core'
const
now
=
useNow
()
ts
const { 
now
,
pause
,
resume
} =
useNow
({
controls
: true })

组件用法

此函数还通过 @vueuse/components 包提供了一个无渲染组件版本。了解更多用法

vue
<template>
  <UseNow v-slot="{ 
now
,
pause
,
resume
}">
Now: {{
now
}}
<
button
@
click
="
pause
()">
Pause </
button
>
<
button
@
click
="
resume
()">
Resume </
button
>
</UseNow> </template>

类型声明

ts
export interface 
UseNowOptions
<
Controls
extends boolean> {
/** * Expose more controls * * @default false */
controls
?:
Controls
/** * Start the clock immediately * * @default true */
immediate
?: boolean
/** * Update interval in milliseconds, or use requestAnimationFrame * * @default requestAnimationFrame */
interval
?: "requestAnimationFrame" | number
} /** * Reactive current Date instance. * * @see https://vueuse.org.cn/useNow * @param options * * @__NO_SIDE_EFFECTS__ */ export declare function
useNow
(
options
?:
UseNowOptions
<false>):
Ref
<Date>
export declare function
useNow
(
options
:
UseNowOptions
<true>): {
now
:
Ref
<Date>
} &
Pausable
export type
UseNowReturn
=
ReturnType
<typeof
useNow
>

来源

源代码演示文档

贡献者

Anthony Fu
SerKo
Anthony Fu
NoiseFan
IlyaL
Scott Bedard
OrbisK
Maher
vaakian X
sun0day
Shinigami
wheat
Alex Kozack
Antério Vieira

更新日志

8c521 - feat(components)!: 重构组件并使其保持一致 (#4912)
v13.6.0
d32f8 - refactor: 为所有纯函数添加 @__NO_SIDE_EFFECTS__ 注释 (#4907)
v13.3.0
44660 - feat: 暴露 immediate 选项 (#4768)
0a9ed - feat!: 放弃对 Vue 2 的支持,优化打包并清理 (#4349)

根据 MIT 许可证发布。