Fast 2kB alternative to Moment.js with the same modern API
Day.js Nuxt Module supporting v3
- ⛰ Nuxt 3 ready
- 🚠 Activate any plugin or locale available
- 🌲 Specify default locales and timezones
- Add
dayjs-nuxtdependency to your project
# Using pnpm
pnpm add -D dayjs-nuxt
# Using yarn
yarn add --dev dayjs-nuxt
# Using npm
npm install --save-dev dayjs-nuxt- Add
dayjs-nuxtto themodulessection ofnuxt.config.ts
export default defineNuxtConfig({
modules: [
'dayjs-nuxt'
]
})You can use the provided composables to access Day.js anywhere.
<template>
<div>
<time :datetime="useDayjs('2023-01-01').utc().toString()"> {{ date }} </time>
</div>
</template>You can specify any amount of locales, plugins, set a default locale, and set a default timezone
export default defineNuxtConfig({
modules: ['dayjs-nuxt'],
dayjs: {
locales: ['en', 'fr'],
plugins: ['relativeTime', 'utc', 'timezone'],
defaultLocale: 'en',
defaultTimezone: 'America/New_York',
}
})By default we include the relativeTime and utc plugins
For example, is need to add an external plugin
// plugins/dayjs.plugin.ts
import dayjsBusinessTime from 'dayjs-business-time'
export default defineNuxtPlugin(() => {
useDayjs().extend(dayjsBusinessTime)
})Instead of a locale string in defaultLocale:, you can define an array with a custom locale. See dayjs customization for more information.
Here is an example for a relativeTime configuration, lets create one that Gollum would understand:
export default defineNuxtConfig({
modules: ['dayjs-nuxt'],
dayjs: {
locales: ['en', 'fr'],
plugins: ['relativeTime'],
defaultLocale: ['en', {
relativeTime: {
future: "in %s",
past: "%s ago",
s: 'a few secondses',
m: "a minute",
mm: "%d minuteses",
h: "an hour",
hh: "%d hourses",
d: "a day",
dd: "%d dayses",
M: "a month",
MM: "%d monthseses",
y: "a year",
yy: "%d yearseses"
}
}]
...
}
})# Install dependencies
npm install
# Generate type stubs
npm run dev:prepare
# Develop with the playground
npm run dev
# Build the playground
npm run dev:build
# Run ESLint
npm run lint
# Run Vitest
npm run test
npm run test:watch
# Release new version
npm run release
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent