DateUtils

函数:

z转表格日期(jsdate) → {Number}

说明:

• 将JavaScript日期对象转换为Excel表格日期格式

别名:

• toExcelDate

参数列表:

返回值:

Type

Number

例子

var excelDate = DateUtils.z转表格日期(jsdate);
console.log(excelDate); // 转换后的Excel表格日期格式

toExcelDate(jsdate) → {Number}

说明:

• 将JavaScript日期对象转换为Excel日期格式

别名:

• z转表格日期

参数列表:

返回值:

Type

Number

例子

var excelDate = DateUtils.toExcelDate(jsdate);
console.log(excelDate); // 转换后的Excel日期格式

z日期格式化(jsdate, fmt) → {String}

说明:

• 格式化JavaScript日期对象为指定格式的字符串
  y-年 M-月,d-日 时-H 分-m 秒-s 毫秒-SSS 星期-aaa

别名:

• format

参数列表:

返回值:

Type

String

例子

var formattedDate = DateUtils.z日期格式化(jsdate, fmt);
console.log(formattedDate); // 格式化后的日期字符串

format(jsdate, fmt) → {String}

说明:

• 格式化JavaScript日期对象为指定格式的字符串
  y-年 M-月,d-日 时-H 分-m 秒-s 毫秒-SSS 星期-aaa

别名:

• z日期格式化

参数列表:

返回值:

Type

String

例子

var formattedDate = DateUtils.format(jsdate, fmt);
console.log(formattedDate); // 格式化后的日期字符串

z加天(jsdate, days) → {Date}

说明:

• 在指定日期上添加指定天数

别名:

• addDays

参数列表:

返回值:

Type

Date

例子

var newDate = DateUtils.z加天(jsdate, days);
console.log(newDate); // 添加天数后的JavaScript日期对象

addDays(jsdate, days) → {Date}

说明:

• 在指定日期上添加指定天数

别名:

• z加天

参数列表:

返回值:

Type

Date

例子

var newDate = DateUtils.addDays(new Date, 15);
console.log(newDate); // 添加天数后的JavaScript日期对象

z加时间(jsdate, t) → {Date}

说明:

• 在指定日期上添加指定时间

别名:

• addTimes

参数列表:

返回值:

Type

Date

例子

var newDate = DateUtils.z加时间(jsdate, t);
console.log(newDate); // 添加时间后的JavaScript日期对象

addTimes(jsdate, t) → {Date}

说明:

• 在指定日期上添加指定时间

别名:

• z加时间

参数列表:

返回值:

Type

Date

例子

var newDate = DateUtils.addTimes(jsdate, t);
console.log(newDate); // 添加时间后的JavaScript日期对象

z加月(jsdate, m) → {Date}

说明:

• 在指定日期上添加指定月份

别名:

• addMonths

参数列表:

返回值:

Type

Date

例子

var newDate = DateUtils.z加月(jsdate, m);
console.log(newDate); // 添加月份后的JavaScript日期对象

addMonths(jsdate, m) → {Date}

说明:

• 在指定日期上添加指定月份

别名:

• z加月

参数列表:

返回值:

Type

Date

例子

var newDate = DateUtils.addMonths(jsdate, m);
console.log(newDate); // 添加月份后的JavaScript日期对象

z加年(jsdate, y) → {Date}

说明:

• 在指定日期上添加指定年份

别名:

• addYears

参数列表:

返回值:

Type

Date

例子

var newDate = DateUtils.z加年(jsdate, y);
console.log(newDate); // 添加年份后的JavaScript日期对象

addYears(jsdate, y) → {Date}

说明:

• 在指定日期上添加指定年份

别名:

• z加年

参数列表:

返回值:

Type

Date

例子

var newDate = DateUtils.addYears(jsdate, y);
console.log(newDate); // 添加年份后的JavaScript日期对象

z年(jsdate) → {Number}

说明:

• 获取指定日期的年份

别名:

• year

参数列表:

返回值:

Type

Number

例子

var year = DateUtils.z年(jsdate);
console.log(year); // 指定日期的年份

year(jsdate) → {Number}

说明:

• 获取指定日期的年份

别名:

• z年

参数列表:

返回值:

Type

Number

例子

var year = DateUtils.year(jsdate);
console.log(year); // 指定日期的年份

z月(jsdate) → {Number}

说明:

• 获取指定日期的月份

别名:

• month

参数列表:

返回值:

Type

Number

例子

var month = DateUtils.z月(jsdate);
console.log(month); // 指定日期的月份

month(jsdate) → {Number}

说明:

• 获取指定日期的月份

别名:

• z月

参数列表:

返回值:

Type

Number

例子

var month = DateUtils.month(jsdate);
console.log(month); // 指定日期的月份

z日(jsdate) → {Number}

说明:

• 获取指定日期的日份

别名:

• day

参数列表:

返回值:

Type

Number

例子

var day = DateUtils.z日(jsdate);
console.log(day); // 指定日期的日份

day(jsdate) → {Number}

说明:

• 获取指定日期的日份

别名:

• z日

参数列表:

返回值:

Type

Number

例子

var day = DateUtils.day(jsdate);
console.log(day); // 指定日期的日份

z星期(jsdate) → {Number}

说明:

• 获取指定日期的星期几（以数字表示）

别名:

• weekday

参数列表:

返回值:

Type

Number

例子

var weekday = DateUtils.z星期(jsdate);
console.log(weekday); // 指定日期的星期几

weekday(jsdate) → {Number}

说明:

• 获取指定日期的星期几（以数字表示）

别名:

• z星期

参数列表:

返回值:

Type

Number

例子

var weekday = DateUtils.weekday(jsdate);
console.log(weekday); // 指定日期的星期几

z星期中文(jsdate) → {String}

说明:

• 获取指定日期的星期几（以中文字符串表示）

别名:

• weekdayCn

参数列表:

返回值:

Type

String

例子

var weekdayCn = DateUtils.z星期中文(jsdate);
console.log(weekdayCn); // 指定日期的星期几（中文）

weekdayCn(jsdate) → {String}

说明:

• 获取指定日期的星期几（以中文字符串表示）

别名:

• z星期中文

参数列表:

返回值:

Type

String

例子

var weekdayCn = DateUtils.weekdayCn(jsdate);
console.log(weekdayCn); // 指定日期的星期几（中文）

z季度(jsdate) → {Number}

说明:

• 获取指定日期的季度

别名:

• quarter

参数列表:

返回值:

Type

Number

例子

var quarter = DateUtils.z季度(jsdate);
console.log(quarter); // 指定日期的季度

quarter(jsdate) → {Number}

说明:

• 获取指定日期的季度

别名:

• z季度

参数列表:

返回值:

Type

Number

例子

var quarter = DateUtils.quarter(jsdate);
console.log(quarter); // 指定日期的季度

z当月天数(jsdate) → {Number}

说明:

• 获取指定日期所在月份的天数

别名:

• daysOfMonth

参数列表:

返回值:

Type

Number

例子

var days = DateUtils.z当月天数(jsdate);
console.log(days); // 指定日期所在月份的天数

daysOfMonth(jsdate) → {Number}

说明:

• 获取指定日期所在月份的天数

别名:

• z当月天数

参数列表:

返回值:

Type

Number

例子

var days = DateUtils.daysOfMonth(jsdate);
console.log(days); // 指定日期所在月份的天数

z月初(jsdate) → {Number}

说明:

• 获取指定日期所在月份的第一天

别名:

• firstDayOfMonth

参数列表:

返回值:

Type

Number

例子

var firstDay = DateUtils.z月初(jsdate);
console.log(firstDay); // 指定日期所在月份的第一天

firstDayOfMonth(jsdate) → {Number}

说明:

• 获取指定日期所在月份的第一天

别名:

• z月初

参数列表:

返回值:

Type

Number

例子

var firstDay = DateUtils.firstDayOfMonth(jsdate);
console.log(firstDay); // 指定日期所在月份的第一天

z月底(jsdate) → {Date}

说明:

• 获取指定日期所在月份的最后一天

别名:

• endOfMonth

参数列表:

返回值:

Type

Date

例子

var lastDay = DateUtils.z月底(jsdate);
console.log(lastDay.format()); // 指定日期所在月份的最后一天

endOfMonth(jsdate) → {Number}

说明:

• 获取指定日期所在月份的最后一天

别名:

• z月底

参数列表:

返回值:

Type

Number

例子

var lastDay = DateUtils.endOfMonth(jsdate);
console.log(lastDay); // 指定日期所在月份的最后一天

z转VBA日期数值(jsdate) → {Number}

说明:

• 将JavaScript日期对象转换为VBA日期数值

别名:

• cdate

参数列表:

返回值:

Type

Number

例子

var vbaDate = DateUtils.z转VBA日期数值(jsdate);
console.log(vbaDate); // 转换后的VBA日期数值

cdate(jsdate) → {Number}

说明:

• 将JavaScript日期对象转换为VBA日期数值

别名:

• z转VBA日期数值

参数列表:

返回值:

Type

Number

例子

var vbaDate = DateUtils.cdate(jsdate);
console.log(vbaDate); // 转换后的VBA日期数值

z表格日期转JS(xlsdate) → {Date}

说明:

• 将Excel日期数值转换为JavaScript日期对象

别名:

• fromExcelDate

参数列表:

返回值:

Type

Date

例子

var jsDate = DateUtils.z表格日期转JS(xlsdate);
console.log(jsDate); // 转换后的JavaScript日期对象

fromExcelDate(xlsdate) → {Date}

说明:

• 将Excel日期数值转换为JavaScript日期对象

别名:

• z表格日期转JS

参数列表:

返回值:

Type

Date

例子

var jsDate = DateUtils.fromExcelDate(xlsdate);
console.log(jsDate); // 转换后的JavaScript日期对象

z今天日期() → {String}

说明:

• 获取当前日期的字符串表示（格式为YYYY-MM-DD）

别名:

• today

返回值:

Type

String

例子

var today = DateUtils.z今天日期();
console.log(today); // 当前日期的字符串表示

today() → {String}

说明:

• 获取当前日期的字符串表示（格式为YYYY-MM-DD）

别名:

• z今天日期

返回值:

Type

String

例子

var today = DateUtils.today();
console.log(today); // 当前日期的字符串表示

z日期时间() → {String}

说明:

• 获取当前日期和时间的字符串表示（格式为YYYY-MM-DD HH:mm:ss）

别名:

• now

返回值:

Type

String

例子

var datetime = DateUtils.z日期时间();
console.log(datetime); // 当前日期和时间的字符串表示

now() → {String}

说明:

• 获取当前日期和时间的字符串表示（格式为YYYY-MM-DD HH:mm:ss）

别名:

• z日期时间

返回值:

Type

String

例子

var datetime = DateUtils.now();
console.log(datetime); // 当前日期和时间的字符串表示

z时间() → {String}

说明:

• 获取当前时间的字符串表示（格式为HH:mm:ss）

别名:

• time

返回值:

Type

String

例子

var time = DateUtils.z时间();
console.log(time); // 当前时间的字符串表示

time() → {String}

说明:

• 获取当前时间的字符串表示（格式为HH:mm:ss）

别名:

• z时间

返回值:

Type

String

例子

var time = DateUtils.time();
console.log(time); // 当前时间的字符串表示

z日期间隔(dmin, dmax) → {String}

说明:

• 计算两个日期之间的间隔（以天为单位）

别名:

• datedif

参数列表:

返回值:

Type

String

例子

var interval = DateUtils.z日期间隔(dmin, dmax);
console.log(interval); // 两个日期之间的间隔的字符串表示

datedif(dmin, dmax) → {String}

说明:

• 计算两个日期之间的间隔（以天为单位）

别名:

• z日期间隔

参数列表:

返回值:

Type

String

例子

var interval = DateUtils.datedif(dmin, dmax);
console.log(interval); // xxx年xx月xx天

z只留日期(d) → {Number}

说明:

• 保留给定日期的日期部分，将其他部分置为0

别名:

• justDate

参数列表:

返回值:

Type

Number

例子

// 示例
z只留日期(new Date()); // 返回处理后的日期部分

justDate(d) → {Number}

说明:

• 保留给定日期的时间部分，将其他部分置为0

别名:

• z只留日期

参数列表:

返回值:

Type

Number

例子

// 示例
justDate(new Date()); // 返回处理后的时间部分

z只留时间(d) → {Number}

说明:

• 保留给定日期的日期部分，将其他部分置为0

别名:

• justTime

参数列表:

返回值:

Type

Number

例子

// 示例
z只留时间(new Date()); // 返回处理后的日期部分

justTime(d) → {Number}

说明:

• 保留给定日期的时间部分，将其他部分置为0

别名:

• z只留时间

参数列表:

返回值:

Type

Number

例子

// 示例
justTime(new Date()); // 返回处理后的时间部分