Home > sculp-js > adjustDate

adjustDate() function

调整日期（增加或减少特定时间单位）

Signature:

export declare function adjustDate(originDate: DateValue, options?: CalculateDateOptions): string | Date;

Parameters

Parameter	Type	Description
originDate	DateValue	参考日期，可以是 Date 对象、时间戳或日期字符串
options	CalculateDateOptions	(Optional) 配置项，支持多种时间单位

Returns:

string | Date

{string | Date} 计算后的日期/日期时间字符串或 Date 对象

Example

// 基础用法（向后 2 天） adjustDate('2024-01-01', { days: 2 }) // '2024-01-03'

// 向前 2 天 adjustDate('2024-01-01', { days: -2 }) // '2023-12-30'

// 向后 1 年 2 个月 3 天 adjustDate('2024-01-01', { years: 1, months: 2, days: 3 }) // '2025-03-04'

// 向后 2 周 adjustDate('2024-01-01', { weeks: 2 }) // '2024-01-15'

// 包含时间（向后 2 天 3 小时 30 分钟） adjustDate('2024-01-01 10:30:00', { days: 2, hours: 3, minutes: 30 }) // '2024-01-03 14:00'

// 自定义格式 adjustDate('2024-01-01', { days: 2, format: 'YYYY/MM/DD' }) // '2024/01/03' adjustDate('2024-01-01', { days: 2, format: 'YYYY 年 MM 月 DD 日' }) // '2024 年 01 月 03 日'

// 时间戳输入 adjustDate(1717330884896, { days: 2 }) // '2024-06-04'

// 精确到毫秒 adjustDate('2024-01-01 10:30:00', { hours: 1, minutes: 30, seconds: 45, milliseconds: 500 })

// 返回 Date 对象 adjustDate('2024-01-01', { days: 2, returnDate: true }) // Date 对象