addTime 日期增加

更新: 1970/1/1 字数: 0 字 时长: 0 分钟

说明

addTime 函数用于在给定的基准时间上添加指定的时间量，并返回计算后的时间。

🛠️ 函数签名

/**
 * 添加时间
 * @param {string|number|Date} time - 基准时间
 * @param {number} amount - 要添加的时间量
 * @param {string} unit - 时间单位（年、月、日、小时、分钟、秒）
 * @returns {Date} - 计算后的时间
 */
export function addTime(time, amount, unit)

参数

参数	说明	类型	可选值	默认值
time	基准时间	string / number / Date	—	—
amount	添加的时间量	number	—	—
unit	时间单位	string	'年' / '月' / '日' / '天' / '小时' / '分钟' / '秒'	—

返回值

• Date：计算后的时间，以 Date 对象形式返回。

示例

基本用法

import { addTime } from 'uviewos';

// 在当前时间上添加 5 天
const newDate = addTime(new Date(), 5, '天');
console.log(newDate);
// 输出: 当前时间加上 5 天的日期

添加年、月、小时、分钟、秒等

import { addTime } from 'uviewos';

// 在当前时间上添加 2 年
const newDateYear = addTime(new Date(), 2, '年');
console.log(newDateYear);
// 输出: 当前时间加上 2 年的日期

// 在当前时间上添加 3 个月
const newDateMonth = addTime(new Date(), 3, '月');
console.log(newDateMonth);
// 输出: 当前时间加上 3 个月的日期

// 在当前时间上添加 10 小时
const newDateHour = addTime(new Date(), 10, '小时');
console.log(newDateHour);
// 输出: 当前时间加上 10 小时的日期
// 在当前时间上添加 15 分钟
const newDateMinute = addTime(new Date(), 15, '分钟');
console.log(newDateMinute);
// 输出: 当前时间加上 15 分钟的日期

// 在当前时间上添加 45 秒
const newDateSecond = addTime(new Date(), 45, '秒');
console.log(newDateSecond);
// 输出: 当前时间加上 45 秒的日期

错误处理

import { addTime } from 'uviewos';

try {
  // 尝试添加无效的时间单位
  const invalidDate = addTime(new Date(), 5, '周');
} catch (error) {
  console.error(error.message);
  // 输出: 无效的单位
}