Nuxt Day.js module

Day.js Nuxt 模組

快速的 2kB 替代方案，取代 Moment.js，並具有相同的現代 API

Day.js 支援 v3 的 Nuxt 模組

功能

⛰ Nuxt 3 就緒
🚠 啟用任何可用的外掛程式或語言環境
🌲 指定預設語言環境和時區

快速設定

將 dayjs-nuxt 依賴項新增至您的專案

npx nuxi@latest module add dayjs

將 dayjs-nuxt 新增至 nuxt.config.ts 的 modules 區段

export default defineNuxtConfig({
  modules: [
    'dayjs-nuxt'
  ]
})

基本用法

您可以使用提供的 $dayjs 在模板中存取 Day.js。

<template>
  <div>
    <time :datetime="$dayjs('2023-01-01').utc().toString()"> {{ date }} </time>
  </div>
</template>

Composables

您可以使用 useDayjs composable 在任何地方存取 Day.js。

<script setup>
  import { useDayjs } from '#dayjs' // not need if you are using auto import
  const dayjs = useDayjs()
  dayjs.locale('fr')
  dayjs.extend(...)
</script>

設定

您可以指定任意數量的語言環境、外掛程式、設定預設語言環境和設定預設時區

export default defineNuxtConfig({
  modules: ['dayjs-nuxt'],
  dayjs: {
    locales: ['en', 'fr'],
    plugins: ['relativeTime', 'utc', 'timezone'],
    defaultLocale: 'en',
    defaultTimezone: 'America/New_York',
  }
})

預設情況下，我們會包含 relativeTime 和 utc 外掛程式，並始終導入 updateLocale

外部外掛程式

export default defineNuxtConfig({
  modules: ['dayjs-nuxt'],
  dayjs: {
    ...
    externalPlugins: [{
      name: 'dayjsBusinessDays',
      package: 'dayjs-business-days2',
      option: {
        holidays: [`2023-12-26`],
        holidayFormat: `YYYY-MM-DD`,
      }
    }]
    ...
  }
})

可選的 defaultLocale 自訂

您可以在 defaultLocale: 中定義包含自訂語言環境的陣列，而不是語言環境字串。有關更多資訊，請參閱 dayjs 自訂。

這是一個 relativeTime 設定的範例，讓我們建立一個咕嚕可以理解的設定

export default defineNuxtConfig({
  modules: ['dayjs-nuxt'],
  dayjs: {
    ...
    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