日期#

本文档列出了用于在 表达式 中支持日期数据转换的内置便捷函数。

表达式中的 JavaScript 你可以在表达式中使用任意 JavaScript。更多信息请参见 表达式。

beginningOf(unit?: DurationUnit): Date #

将一个日期转换为指定时间段的开始时刻。返回值可能是 JavaScript Date 或 Luxon Date，具体取决于输入类型。

函数参数#

unit 可选 | 字符串枚举 指定时间单位的有效字符串。 默认值：week 可选值：second, minute, hour, day, week, month, year

---

endOfMonth(): Date #

将一个日期转换为该月最后一天的结束时刻。

---

extract(datePart?: DurationUnit): Number #

从日期中提取由 datePart 指定的部分。返回值可能是 JavaScript Date 或 Luxon Date，具体取决于输入类型。

函数参数#

datePart 可选 | 字符串枚举 指定时间单位的有效字符串。 默认值：week 可选值：second, minute, hour, day, week, month, year

---

format(fmt: TimeFormat): String #

按照给定格式结构对日期进行格式化。

函数参数#

fmt 必需 | 字符串枚举 指定时间格式的有效字符串。格式参考请见 Luxon | Token 表格。

---

isBetween(date1: Date | DateTime, date2: Date | DateTime): Boolean #

检查某个日期是否介于两个给定日期之间。

函数参数#

date1 必需 | Date 或 DateTime 范围内的第一个日期。

date2 必需 | Date 或 DateTime 范围内的最后一个日期。

---

isDst(): Boolean #

检查该日期是否处于夏令时期间（Daylight Saving Time）。

---

isInLast(n?: Number, unit?: DurationUnit): Boolean #

检查某个日期是否位于指定的时间段内（例如“最近7天”）。

函数参数#

n 可选 | 数字 时间单位的数量。例如，若要判断日期是否在过去九周内，则输入 9。 默认值：0

unit 可选 | 字符串枚举 指定时间单位的有效字符串。 默认值：minutes 可选值：second, minute, hour, day, week, month, year

---

isWeekend(): Boolean #

检查该日期是否为星期六或星期日。

---

minus(n: Number, unit?: DurationUnit): Date #

从一个日期中减去指定的时间段。返回值可能是 JavaScript Date 或 Luxon Date，具体取决于输入类型。

函数参数#

n 必需 | 数字 要减去的时间单位数量。例如，若要减去九秒，则此处输入 9。

unit 可选 | 字符串枚举 指定时间单位的有效字符串。 默认值：milliseconds 可选值：second, minute, hour, day, week, month, year

---

plus(n: Number, unit?: DurationUnit): Date #

向一个日期添加指定的时间段。返回值可能是 JavaScript Date 或 Luxon Date，具体取决于输入类型。

函数参数#

n 必需 | 数字 要添加的时间单位数量。例如，若要增加九秒，则此处输入 9。

unit 可选 | 字符串枚举 指定时间单位的有效字符串。 默认值：milliseconds 可选值：second, minute, hour, day, week, month, year

---

toDateTime(): Date #

将 JavaScript 日期对象转换为 Luxon 日期对象。

---