useNow

类别

Animation

导出体积

676 B

上次更改

2 months ago

响应式的当前日期实例。

示例

源码 playground (beta)

当前: Thu Sep 18 2025 15:21:16 GMT+0000 (Coordinated Universal Time)

使用方法

import { useNow
 } from '@vueuse/core'

const now
 = useNow
()

const { now
, pause
, resume
 } = useNow
({ controls
: true })

组件使用

vue

<template>
  <UseNow v-slot="{ now
, pause
, resume
 }">
    当前时间：{{ now
 }}
    <button
 @click
="pause
()">
      暂停
    </button
>
    <button
 @click
="resume
()">
      恢复
    </button
>
  </UseNow>
</template>

类型声明

export interface UseNowOptions
<Controls
 extends boolean> {
  /**
   * 暴露更多控制选项
   *
   * @default false
   */
  controls
?: Controls

  /**
   * 立即开始计时
   *
   * @default true
   */
  immediate
?: boolean
  /**
   * 更新间隔，单位为毫秒，或使用 requestAnimationFrame
   *
   * @default requestAnimationFrame
   */
  interval
?: "requestAnimationFrame" | number
}
/**
 * 反应性当前 Date 实例
 *
 * @see https://vueuse.org/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
>