useNow

Demo

Now: Sun Mar 01 2026 06:29:30 GMT+0000 (Coordinated Universal Time)

Usage

import { useNow
 } from '@vueuse/core'

const now
 = useNow
()

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

Component Usage

This function also provides a renderless component version via the @vueuse/components package. Learn more about the usage.

vue

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

Type Declarations

Show Type Declarations

export interface UseNowOptions
<
  Controls
 extends boolean,
> extends ConfigurableScheduler {
  /**
   * Expose more controls
   *
   * @default false
   */
  controls
?: Controls

  /**
   * Start the clock immediately
   *
   * @deprecated Please use `scheduler` option instead
   * @default true
   */
  immediate
?: boolean
  /**
   * Update interval in milliseconds, or use requestAnimationFrame
   *
   * @deprecated Please use `scheduler` option instead
   * @default requestAnimationFrame
   */
  interval
?: "requestAnimationFrame" | number
}
export type UseNowReturn
<Controls
 extends boolean> = Controls
 extends true
  ? {
      now
: ShallowRef
<Date>
    } & Pausable

  : ShallowRef
<Date>
/**
 * Reactive current Date instance.
 *
 * @see https://vueuse.org/useNow
 * @param options
 *
 * @__NO_SIDE_EFFECTS__
 */
export declare function useNow
(options
?: UseNowOptions
<false>): ShallowRef
<Date>
export declare function useNow
(options
: UseNowOptions
<true>): {
  now
: ShallowRef
<Date>
} & Pausable