Day.js 基本使用指南

npm install dayjs

const dayjs = require("dayjs")
//import dayjs from 'dayjs' // ES 2015
dayjs().format()

<script src="path/to/dayjs/dayjs.min.js"></script>
<script>
  dayjs().format()
</script>

<!-- CDN example (jsDelivr) -->
<script src="https://cdn.jsdelivr.net/npm/dayjs@1/dayjs.min.js"></script>
<script>
  dayjs().format()
</script>

npm install dayjs

import * as dayjs from 'dayjs'
dayjs().format()

{
  //tsconfig.json
  "compilerOptions": {
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true
  }
}

import * as dayjs from "dayjs"
import * as isLeapYear from "dayjs/plugin/isLeapYear" // 导入插件
import "dayjs/locale/zh-cn" // 导入本地化语言

dayjs.extend(isLeapYear) // 使用插件
dayjs.locale("zh-cn") // 使用本地化语言

var now = dayjs()
// 等同于 dayjs(new Date()) 的调用

dayjs("2018-04-04T16:00:00.000Z")
dayjs("2018-04-13 19:18:17.040+02:00")
dayjs("2018-04-13 19:18")

dayjs.extend(customParseFormat)
dayjs("12-25-1995", "MM-DD-YYYY")

require("dayjs/locale/zh-cn")
dayjs("2018 三月 15", "YYYY MMMM DD", "zh-cn")

dayjs("1970-00-00", "YYYY-MM-DD").isValid() // true
dayjs("1970-00-00", "YYYY-MM-DD", true).isValid() // false
dayjs("1970-00-00", "YYYY-MM-DD", "es", true).isValid() // false

dayjs("12-25-2001", ["YYYY", "YYYY-MM-DD"], "es", true)

dayjs(1318781876406)

dayjs.unix(1318781876)

var d = new Date(2018, 8, 18)
var day = dayjs(d)

dayjs.extend(objectSupport)
dayjs({ hour: 15, minute: 10 })
dayjs.utc({ y: 2010, M: 3, d: 5, h: 15, m: 10, s: 3, ms: 123 })
dayjs({ year: 2010, month: 3, day: 5, hour: 15, minute: 10, second: 3, millisecond: 123 })
dayjs({ years: 2010, months: 3, date: 5, hours: 15, minutes: 10, seconds: 3, milliseconds: 123 })

dayjs.extend(arraySupport)
dayjs([2010, 1, 14, 15, 25, 50, 125]) // February 14th, 3:25:50.125 PM
dayjs.utc([2010, 1, 14, 15, 25, 50, 125])
dayjs([2010]) // January 1st
dayjs([2010, 6]) // July 1st
dayjs([2010, 6, 10]) // July 10th

dayjs.extend(utc)

// 默认是当地时间
dayjs().format() //2019-03-06T08:00:00+08:00
// UTC 时间
dayjs.utc().format() // 2019-03-06T00:00:00Z

var a = dayjs()
var b = a.clone()
// a 和 b 是两个独立的 Day.js 对象
var a = dayjs()
var b = dayjs(a)

dayjs("2022-01-33").isValid()
// true, parsed to 2022-02-02
dayjs("some invalid string").isValid()
// false
dayjs("2022-02-31", "YYYY-MM-DD", true).isValid()
// false

dayjs().second(30).valueOf() // => new Date().setSeconds(30)
dayjs().second() // => new Date().getSeconds()

dayjs.utc().second(30).valueOf() // => new Date().setUTCSeconds(30)
dayjs.utc().second() // => new Date().getUTCSeconds()

// gets current millisecond
dayjs().millisecond() // 372
dayjs().millisecond(1) // 返回一个 day.js对象

dayjs().second() // gets current second
dayjs().second(1) // returns new dayjs object

dayjs().minute() // gets current minute
dayjs().minute(59) // returns new dayjs object

dayjs().hour() // gets current hour
newDate = dayjs().hour(12) // returns new dayjs object

dayjs().date() // gets day of current month
dayjs().date(1) // returns new dayjs object

dayjs().day() // gets day of current week
dayjs().day(0) // returns new dayjs object

dayjs.extend(weekday)

// 当星期天是一周的第一天
dayjs().weekday(-7) // last Sunday
dayjs().weekday(7) // next Sunday

// 当星期一是一周的第一天
dayjs().weekday(-7) // last Monday
dayjs().weekday(7) // next Monday

// 当星期天是一周的第一天
dayjs().weekday(-5) // last Tuesday (5th day before Sunday)
dayjs().weekday(5) // next Friday (5th day after Sunday)

dayjs.extend(isoWeek)

dayjs().isoWeekday() // gets the current ISO day of the week
dayjs().isoWeekday(1) // Monday

dayjs.extend(dayOfYear)

dayjs("2010-01-01").dayOfYear() // 1
dayjs("2010-01-01").dayOfYear(365) // 2010-12-31

dayjs.extend(weekOfYear)

dayjs("2018-06-27").week() // 26
dayjs("2018-06-27").week(5) // returns new dayjs object

dayjs.extend(isoWeek)

dayjs().isoWeek() // gets the current ISO week of the year
newDate = dayjs().isoWeek(2) // returns new dayjs object

dayjs().month() // gets current month
dayjs().month(0) // returns new dayjs object

dayjs.extend(quarterOfYear)

dayjs("2010-04-01").quarter() // 2
dayjs("2010-04-01").quarter(2) // returns new dayjs object

dayjs().year() // gets current year
dayjs().year(2000) // returns new dayjs object

dayjs.extend(weekYear)
dayjs.extend(weekOfYear)

dayjs().weekYear()

dayjs.extend(isoWeek)

dayjs().isoWeekYear()

dayjs.extend(isoWeeksInYear)
dayjs.extend(isLeapYear)

dayjs("2004-01-01").isoWeeksInYear() // 53
dayjs("2005-01-01").isoWeeksInYear() // 52

dayjs().get(unit) === dayjs()[unit]()

dayjs().get("year")
dayjs().get("month") // start 0
dayjs().get("date")
dayjs().get("hour")
dayjs().get("minute")
dayjs().get("second")
dayjs().get("millisecond")

dayjs().set(unit, value) === dayjs()[unit](value)

dayjs().set(unit, value) === dayjs()[unit](value)
dayjs().set("date", 1)
dayjs().set("month", 3) // 四月
dayjs().set("second", 30)

dayjs().set("hour", 5).set("minute", 55).set("second", 15)

dayjs.extend(minMax)

dayjs.max(dayjs(), dayjs("2018-01-01"), dayjs("2019-01-01"))
dayjs.max([dayjs(), dayjs("2018-01-01"), dayjs("2019-01-01")])

dayjs.extend(minMax)

dayjs.min(dayjs(), dayjs("2018-01-01"), dayjs("2019-01-01"))
dayjs.min([dayjs(), dayjs("2018-01-01"), dayjs("2019-01-01")])

dayjs().format() // 默认格式: '2020-04-02T08:02:17-05:00'
dayjs().format("YYYY-MM-DD HH:mm:ss") // '2020-04-02 08:02:17'

dayjs.extend(advancedFormat)

dayjs().format("Q Do k kk X x")

dayjs().add(7, "day") // 增加七天
dayjs().add(7, "month") // 增加七个月
dayjs().add(7, "year") // 增加七年

dayjs().subtract(7, "year") // 减少七年

dayjs().startOf("year") // 今年一月1日 00:00:00
dayjs().startOf("month") // 本月1日 00:00:00
dayjs().startOf("week") // 本周的第一天 00:00:00
dayjs().startOf("day") // 今天 00:00:00
dayjs().startOf("hour") // 当前小时 00:00:00

dayjs().endOf("month") // 本月最后一天 23:59:59

dayjs("2010-10-20").isBefore(dayjs("2010-10-21")) // true

dayjs("2010-10-20").isSame(dayjs("2010-10-20")) // true

dayjs("2010-10-20").isAfter(dayjs("2010-10-19")) // true

dayjs("2010-10-20").isSameOrBefore(dayjs("2010-10-21")) // true
dayjs("2010-10-20").isSameOrBefore(dayjs("2010-10-20")) // true

dayjs("2010-10-20").isSameOrAfter(dayjs("2010-10-19")) // true
dayjs("2010-10-20").isSameOrAfter(dayjs("2010-10-20")) // true

dayjs("2010-10-20").isBetween(dayjs("2010-10-19"), dayjs("2010-10-25")) // true

dayjs.extend(isLeapYear)

dayjs("2000-01-01").isLeapYear() // true

dayjs.extend(isSameOrBefore)
dayjs.extend(isSameOrAfter)

dayjs("2010-10-20").isSameOrBefore("2010-10-21", "year") // true
dayjs("2010-10-20").isSameOrAfter("2010-10-19", "year") // true

import customParseFormat from "dayjs/plugin/customParseFormat"
dayjs.extend(customParseFormat)

dayjs("12-25-1995", "MM-DD-YYYY")

import relativeTime from "dayjs/plugin/relativeTime"
dayjs.extend(relativeTime)

dayjs("1999-01-01").fromNow() // 24 years ago

import utc from "dayjs/plugin/utc"
dayjs.extend(utc)

dayjs.utc().format()

import timezone from "dayjs/plugin/timezone"
import utc from "dayjs/plugin/utc"

dayjs.extend(utc)
dayjs.extend(timezone)

dayjs.tz("2019-01-01", "America/New_York")

import "dayjs/locale/zh-cn" // 导入中文语言包

dayjs.locale("zh-cn") // 使用中文

dayjs().format("dddd, MMMM DD, YYYY") // 星期三, 三月 15, 2023

// 计算距离目标日期的剩余时间
function countdown(targetDate) {
  const now = dayjs()
  const target = dayjs(targetDate)
  const diff = target.diff(now)

  if (diff <= 0) return "已结束"

  const days = target.diff(now, "day")
  const hours = target.diff(now, "hour") % 24
  const minutes = target.diff(now, "minute") % 60
  const seconds = target.diff(now, "second") % 60

  return `${days}天 ${hours}小时 ${minutes}分钟 ${seconds}秒`
}

// 使用示例
console.log(countdown("2023-12-31 23:59:59"))

// 根据时间显示不同的格式
function formatTime(date) {
  const now = dayjs()
  const target = dayjs(date)
  const diffDays = now.diff(target, "day")

  if (diffDays === 0) {
    // 今天
    return target.format("HH:mm")
  } else if (diffDays === 1) {
    // 昨天
    return `昨天 ${target.format("HH:mm")}`
  } else if (diffDays < 7) {
    // 一周内
    return target.format("dddd HH:mm")
  } else {
    // 超过一周
    return target.format("MM-DD HH:mm")
  }
}

// 使用示例
console.log(formatTime("2023-03-15 14:30:00"))

// 计算工作日（排除周末）
function addWorkdays(startDate, days) {
  let date = dayjs(startDate)
  let remainingDays = days

  while (remainingDays > 0) {
    date = date.add(1, "day")
    // 周末不算工作日
    if (date.day() !== 0 && date.day() !== 6) {
      remainingDays--
    }
  }

  return date
}

// 使用示例
console.log(addWorkdays("2023-03-15", 5).format("YYYY-MM-DD"))

// 获取常用时间范围
function getTimeRange(type) {
  const now = dayjs()

  switch (type) {
    case "today":
      return {
        start: now.startOf("day"),
        end: now.endOf("day")
      }
    case "yesterday":
      return {
        start: now.subtract(1, "day").startOf("day"),
        end: now.subtract(1, "day").endOf("day")
      }
    case "thisWeek":
      return {
        start: now.startOf("week"),
        end: now.endOf("week")
      }
    case "thisMonth":
      return {
        start: now.startOf("month"),
        end: now.endOf("month")
      }
    case "lastMonth":
      return {
        start: now.subtract(1, "month").startOf("month"),
        end: now.subtract(1, "month").endOf("month")
      }
    default:
      return {
        start: now.startOf("day"),
        end: now.endOf("day")
      }
  }
}

// 使用示例
const { start, end } = getTimeRange("thisWeek")
console.log(`本周范围: ${start.format("YYYY-MM-DD")} 至 ${end.format("YYYY-MM-DD")}`)

import timezone from "dayjs/plugin/timezone"
import utc from "dayjs/plugin/utc"

dayjs.extend(utc)
dayjs.extend(timezone)

// 转换为特定时区
const date = dayjs.tz("2023-03-15 12:00", "America/New_York")

// 获取当前时区
const localDate = dayjs.tz("2023-03-15 12:00", dayjs.tz.guess())

function getWorkdays(startDate, endDate) {
  const start = dayjs(startDate)
  const end = dayjs(endDate)
  let workdays = 0

  let currentDate = start
  while (currentDate.isBefore(end) || currentDate.isSame(end)) {
    // 周末不算工作日
    if (currentDate.day() !== 0 && currentDate.day() !== 6) {
      workdays++
    }
    currentDate = currentDate.add(1, "day")
  }

  return workdays
}

// 使用示例
console.log(getWorkdays("2023-03-01", "2023-03-31"))

import relativeTime from "dayjs/plugin/relativeTime"
dayjs.extend(relativeTime)

dayjs("2023-03-10").fromNow() // 5 days ago
dayjs("2023-03-20").toNow() // in 5 days

import timezone from "dayjs/plugin/timezone"
import utc from "dayjs/plugin/utc"

dayjs.extend(utc)
dayjs.extend(timezone)

// 时区插件会自动处理夏令时
const date = dayjs.tz("2023-03-15 12:00", "America/New_York")