日期函数¶
方法清单¶
| 函数名 | 参数 | 说明 |
|---|---|---|
| getToday() | 无 | 获取当日日期 |
| getDay(date) | date: 日期型参数 | 获取日期 |
| getMonth(date) | date: 日期型参数 | 获取月份 |
| getYear(date) | date: 日期型参数 | 获取年份 |
| parseDate(str, format) | str: 待转换的字符串,需符合format指定的格式;format: 日期格式 | 将字符串按给定格式转换为日期型 |
| diffYears(startDate, endDate) | startDate和endDate是"yyyy-MM-dd"格式的字符串 | 获取相隔年份数 |
| diffMonths(startDate, endDate) | startDate和endDate是"yyyy-MM-dd"格式的字符串 | 获取相隔月份数 |
| diffDays(startDate, endDate) | startDate和endDate是"yyyy-MM-dd"格式的字符串 | 获取相隔天数 |
| diffHours(startDate, endDate) | startDate和endDate是"yyyy-MM-dd"格式的字符串 | 获取相隔小时数 |
| adjustYear(date, num) | date:日期型参数，num:正负整数 | 校正年份 |
| adjustMonth(date, num) | date:日期型参数，num:正负整数 | 校正月份 |
| adjustDay(date, num) | date:日期型参数，num:正负整数 | 校正天数 |
| format(date,formatText) | date:日期型参数;formatText:指定字符串格式 | 把其日期参数转化成指定格式的字符串 |
| getCurDate(formatText) | date:日期型参数formatText:字符串型参数，指定需要显示的格式，如"yyyy-MM-dd HH ss" |
按其参数指定的格式获取当前时间，并以字符串的形式返回 |
方法示例¶
1.getToday()
作用：实现getToday()函数的应用，当前日期
脚本示例：
//表单日期控件的值默认为当前系统时间 (值脚本)
(() => {
const starttime = getItemValueAsDate("日期");
if (starttime == null) {
starttime = DATE.getToday(); //当前日期
}
return starttime;
})()
2.getDay(date)
作用：实现getDay(date)函数的应用，日期天
脚本示例：
//表单某字段值为当前日期中的天 (值脚本)
(() => {
const starttime = getItemValueAsDate("日期");
const day = DATE.getDay(getToday());
if (starttime != null) {
day = getDay(starttime); //取日期天
}
return day;
})()
3.getMonth(date)
作用：实现getMonth(date)函数的应用，取月份
脚本示例：
//表单某字段值为当前日期中的月份 (值脚本)
(() => {
const starttime = getItemValueAsDate("日期");
const month = DATE.getMonth(getToday());
if (starttime != null) {
month = getMonth(starttime); //取月份
}
return month;
})()
4.getYear(date)
作用：实现getYear(date)函数的应用，取年份
脚本示例：
//表单某字段值为当前日期中的年份 (值脚本)
(() => {
const starttime = getItemValueAsDate("日期");
const year = DATE.getYear(getToday());
if (starttime != null) {
year = getYear(starttime); //取年份
}
return year;
})()
5.parseDate(str, format)
作用：实现parseDate (str,fromat)函数的应用，日期转换函数
脚本示例：
//表单某字段值为转换格式之后的日期 (值脚本)
(() => {
const starttime = getItemValue("字符串");
const startdate = null;
if (starttime != null && starttime.trim().length > 0) {
startdate = DATE.parseDate(starttime, "yyyy-MM-dd HH:mm:ss");
}
return startdate;
})()
6.diffYears(startDate, endDate)
作用：实现diffYears(startDate, endDate)函数的应用，相隔年份函数
脚本示例：
//表单某字段值为两个日期的相隔年份 (值脚本)
(() => {
const doc = getCurrentDocument();
const starttime = doc.getItemValueAsDate("开始日期年");
const endtime = doc.getItemValueAsDate("结束日期年");
let diff = "";
if (starttime != null && endtime != null) {
starttime = format(starttime, "yyyy-MM-dd HH:mm:ss");
endtime = format(endtime, "yyyy-MM-dd HH:mm:ss");
diff = DATE.diffYears(starttime, endtime);
}
return diff;
})()
7.diffMonths(startDate, endDate)
作用：实现diffMonths(startDate, endDate)函数的应用，相隔月份函数
脚本示例：
//表单某字段值为两个日期的相隔月份 (值脚本)
(() => {
const doc = getCurrentDocument();
const starttime = doc.getItemValueAsDate("开始日期月");
const endtime = doc.getItemValueAsDate("结束日期月");
let diff = "";
if (starttime != null && endtime != null) {
starttime = format(starttime, "yyyy-MM-dd HH:mm:ss");
endtime = format(endtime, "yyyy-MM-dd HH:mm:ss");
diff = DATE.diffMonths(starttime, endtime);
}
return diff;
})()
8.diffDays(startDate, endDate)
作用：实现diffDays(startDate, endDate)函数的应用，相隔天数函数
脚本示例：
//表单某字段值为两个日期的相隔天数 (值脚本)
((() => {
const doc = getCurrentDocument();
const starttime = doc.getItemValueAsDate("开始日期天");
const endtime = doc.getItemValueAsDate("结束日期天");
let diff = "";
if (starttime != null && endtime != null) {
starttime = format(starttime, "yyyy-MM-dd HH:mm:ss");
endtime = format(endtime, "yyyy-MM-dd HH:mm:ss");
diff = DATE.diffDays(starttime, endtime);
}
return diff;
})()
9.diffHours(startDate, endDate)
作用：实现diffHours(startDate, endDate)函数的应用，相隔小时数函数
脚本示例：
//表单某字段值为两个日期的相隔小时 (值脚本)
(() => {
const doc = getCurrentDocument();
const starttime = doc.getItemValueAsDate("开始日期小时");
const endtime = doc.getItemValueAsDate("结束日期小时");
let diff = "";
if (starttime != null && endtime != null) {
starttime = format(starttime, "yyyy-MM-dd HH:mm:ss");
endtime = format(endtime, "yyyy-MM-dd HH:mm:ss");
diff = DATE.diffHours(starttime, endtime);
}
return diff;
})()
10.adjustYear(date, num)
作用：实现adjustYear(date, num)函数的应用，日期年份校正函数
脚本示例：
//表单某字段值调整年后的值 (值脚本)
(function () {
const starttime = getItemValueAsDate("增加前日期");
const adnumber = getItemValueAsInt("增加数值");
let newtime = null;
if (starttime != null) {
newtime = DATE.adjustYear(starttime, adnumber);
}
return newtime;
})()
11.adjustMonth(date, num)
作用：实现adjustMonth(date, num)函数的应用，日期月份校正函数
脚本示例：
//表单某字段值调整月份后的值 (值脚本)
(() => {
const starttime = getItemValueAsDate("增加前日期月");
const adnumber = getItemValueAsInt("增加数值");
let newtime = null;
if (starttime != null) {
newtime = DATE.adjustMonth(starttime, adnumber);
}
return newtime;
})()
12.adjustDay(date, num)
作用：实现adjustDay(date, num)函数的应用，日期天校正函数
脚本示例：
//表单某字段值调整天数后的值 (值脚本)
(() => {
const starttime = getItemValueAsDate("增加前日期天");
const adnumber = getItemValueAsInt("增加数值");
let newtime = null;
if (starttime != null) {
newtime = DATE.adjustDay(starttime, adnumber);
}
return newtime;
})()
13.format(date,formatText)
作用：实现format(date,formatText)函数的应用，日期转换函数
脚本示例：
//判断表单中的结束日期必须填写和结束日期必须晚于开始日期 (校验脚本)
(() => {
const starttime = getItemValueAsDate("开始日期");
const deadline = getItemValueAsDate("结束日期");
let retvar = "";
if (deadline == null) {
retvar = "结束日期必须填写！";
} else {
const starttime = STRING.format(starttime, "yyyy-MM-dd HH:mm:ss");
const deadline = STRING.format(deadline, "yyyy-MM-dd HH:mm:ss");
if (starttime != null && deadline != null) {
if (starttime >= deadline) {
retvar = "结束日期必须晚于开始日期";
}
}
}
return retvar;
})()
14.getCurDate(formatText)
作用：实现getCurDate(formatText)函数的应用，获取当前日期并以指定格式字符串返回
脚本示例：