此版本支持的时间运算函数有:
Ø !TimeSpanGetHours(iTimeSpan)
Ø !TimeSpanGetMinutes(iTimeSpan)
Ø !TimeSpanGetSeconds(iTimeSpan)
Ø !TimeSpanGetTotalHours(iTimeSpan)
Ø !TimeSpanGetTotalMinutes(iTimeSpan)
Ø !TimeSpanGetTotalSeconds(iTimeSpan)
!TimeStr2I(strTime)
函数意义: 将表示时间的字符串(YYYY-MM-DD HH:MM:SS)转换为时间值
参 数: strTime,字符串,以字符串型表示的时间(YYYY-MM-DD HH:MM:SS)
返 回 值: 整数,转换后的时间值
实 例: iTime = !TimeStr2I("2001-01-01 03:15:28"),将表示时间的字符串"2001-01-01 03:15:28"转换为整数的时间值iTime,iTime = 978290128
注意事项: (1)时间字符串格式为yyyy/MM/dd hh:mm:ss或yyyy-MM-dd hh:mm:ss
(2)时间字符串必须输入完整,否则失败且返回0
(3)时间范围1970年1月1日0时0分1秒-2038年1月19日03时14分07秒
!TimeI2Str(iTime,strFormat)
函数意义: 将时间值转换为字符串表示的时间
参 数: iTime,整数,时间值(大于0小于2147483648)strFormat,字符串,转换后的时间字符串的格式
返 回 值: 字符串,转换后的时间字符串
实 例: strTime = !TimeI2Str(iTime,"%y,%m,%d,%H,%M,%S"),当iTime=0时,strTime为“1970,01,01,00,00,00”.表示1970年1月1日0时0分0秒.
说 明: !TimeI2Str的格式化标准为:
%d,月份中日期的十进制表示。如:07表示7日
%H,24时制的小时表示。如:17表示下午5时
%m,月份的十进制表示。如:06表示6月
%M,分钟的十进制表示。如:28表示28分
%S,秒钟的十进制表示
%X,适合当地的时间表示。如:9时47分12秒表示为:09:47:12
%Y 或者 %y,显示世纪的年的十进制表示。如:2001表示2001年
%%,百分号表示
!TimeGetYear(iTime)
函数意义: 获取时间值iTime中的年份
参 数: iTime,整数,时间值(大于0小于2147483648)
返 回 值: 整数,时间值iTime中的年份(1970~2038)
实 例: ret = !TimeGetYear(iTime), ret为时间值iTime中的年份
注意事项: (1)iTime为!TimeStr2I(strTime)得到的值
(2)年份范围1970-2100
!TimeGetMonth(iTime)
函数意义: 获取时间值iTime中的月份
参 数: iTime,整数,时间值(大于0小于2147483648)
返 回 值: 整数,时间值iTime中的月份(1~12)
实 例: ret = !TimeGetMonth(iTime),ret为时间值iTime中的月份
注意事项: iTime为!TimeStr2I(strTime)得到的值
!TimeGetSecond(iTime)
函数意义: 获取时间值iTime中的秒数
参 数: iTime,整数,时间值(大于0小于2147483648)
返 回 值: 整数,时间值iTime中的秒数(0~59)
实 例: ret = !TimeGetSecond(iTime),ret为时间值iTime中的秒数
注意事项: iTime为!TimeStr2I(strTime)得到的值
!TimeGetSpan(iTime1,iTime2)
函数意义: 计算两个时间iTime1和iTime2之差,单位秒
参 数: iTime1,整数,时间值(大于0小于2147483648)
iTime2,整数,时间值(大于0小于2147483648)
返 回 值: 整数,两时间之差
实 例: ret = !TimeGetSpan(iTime1,iTime2),ret为两个时间iTime1和iTime2之差
注意事项: iTime1和iTime2可以用!TimeStr2I()得到,确保iTime1 > iTime2,避免不必要的错误
!TimeGetDayOfWeek(iTime)
函数意义: 获取时间值iTime中的星期
参 数: iTime,整数,时间值(大于0小于2147483648)
返 回 值: 整数,时间值iTime中的星期
实 例: data = !TimeGetDayOfWeek(iTime),获取时间值iTime中的星期(data的值为1表示星期一, 2表示星期一二,……7表示星期日)
注意事项: iTime为!TimeStr2I(strTime)得到的值
!TimeGetHour(iTime)
函数意义: 获取时间值iTime中的小时
参 数: iTime,整数,时间值(大于0小于2147483648)
返 回 值: 整数,时间值iTime中的小时(0~23)
实 例: ret = !TimeGetHour(iTime),ret为时间值iTime中的小时
注意事项: iTime为!TimeStr2I(strTime)得到的值
!TimeGetMinute(iTime)
函数意义: 获取时间值iTime中的分钟数
参 数: iTime,整数,时间值(大于0小于2147483648)
返 回 值: 整数,时间值iTime中的分钟数(0~59)
实 例: ret = !TimeGetMinute(iTime),ret为时间值iTime中的分钟数
注意事项: iTime为!TimeStr2I(strTime)得到的值
!TimeGetDay(iTime)
函数意义: 获取时间值iTime中的天数
参 数: iTime,整数,时间值(大于0小于2147483648)
返 回 值: 整数,时间值iTime中的天数(1~31)
实 例: ret = !TimeGetDay(iTime),ret为时间值iTime中的日期
注意事项: iTime为!TimeStr2I(strTime)得到的值
函数意义: 获取当前时间值
参 数: 无
返 回 值: 整数,当前的时间值
实 例: ret = !TimeGetCurrentTime(),ret为当前时间值
!TimeSpanGetDays(iTimeSpan)
函数意义: 获取时间差中的天数(时间差由!TimeGetSpan()函数计算得来)
参 数: iTimeSpan,整数,时间差,参数>0且<2147483648
返 回 值: 整数,时间值iTime中的天数(1~31)
实 例: ret = !TimeSpanGetDays(TimeSpan),ret为时间差TimeSpan的天数
注意事项: iTimeSpan为!TimeGetSpan(iTime1,iTime2)的值
!TimeSpanGetHours(iTimeSpan)
函数意义: 获取时间差中的小时数(时间差由TimeGetSpan函数计算得来)
参 数: iTimeSpan,整数,时间差,参数>0且<2147483648
返 回 值: 整数,时间差中的小时数(0~23)
实 例: ret = !TimeSpanGetHours(TimeSpan),ret为时间差TimeSpan中的小时数
注意事项: iTimeSpan为!TimeGetSpan(iTime1,iTime2)的值
!TimeSpanGetMinutes(iTimeSpan)
函数意义: 获取时间差中的分钟数(时间差由TimeGetSpan函数计算得来)
参 数: iTimeSpan,整数,时间差,参数>0且<2147483648
返 回 值: 整数,时间差中的分钟数(0~59)
实 例: ret = !TimeSpanGetMinutes(TimeSpan),ret为时间差TimeSpan中的分钟数
注意事项: iTimeSpan为!TimeGetSpan(iTime1,iTime2)的值
!TimeSpanGetSeconds(iTimeSpan)
函数意义: 获取时间差中的秒数(时间差由TimeGetSpan函数计算得来)
参 数: iTimeSpan,整数,时间差,参数>0且<2147483648
返 回 值: 整数,时间差中的秒数(0~59)
实 例: ret = !TimeSpanGetSeconds(TimeSpan),ret为时间差TimeSpan中的秒数
注意事项: iTimeSpan为!TimeGetSpan(iTime1,iTime2)的值
!TimeSpanGetTotalHours(iTimeSpan)
函数意义: 获取时间差中的小时数(时间差由TimeGetSpan函数计算得来)
参 数: iTimeSpan,整数,时间差,参数>0且<2147483648
返 回 值: 整数,时间差中的小时数
实 例: ret = !TimeSpanGetTotalHours(TimeSpan),ret为时间差TimeSpan中的小时数
注意事项: iTimeSpan为!TimeGetSpan(iTime1,iTime2)的值
!TimeSpanGetTotalMinutes(iTimeSpan)
函数意义: 获取时间差中的分钟数(时间差由TimeGetSpan函数计算得来)
参 数: iTimeSpan,整数,时间差,参数>0且<2147483648
返 回 值: 整数,时间差中的分钟数
实 例: ret = !TimeSpanGetTotalMinutes(TimeSpan),ret为时间差TimeSpan中的分钟数
注意事项: iTimeSpan为!TimeGetSpan(iTime1,iTime2)的值
!TimeSpanGetTotalSeconds(iTimeSpan)
函数意义: 获取时间差中的秒数(时间差由TimeGetSpan函数计算得来)
参 数: iTimeSpan,整数,时间差,参数>0且<2147483648
返 回 值: 整数,时间差中的秒数
实 例: ret = !TimeSpanGetTotalSeconds(TimeSpan),ret为时间差TimeSpan中的秒数
注意事项: iTimeSpan为!TimeGetSpan(iTime1,iTime2)的值
!TimeAdd(iTime,iTimeSpan)
函数意义: 向时间iTime中加入由iTimeSpan的秒数
参 数: iTime,整数,初始时间值iTimeSpan,整数,要加的秒数
返 回 值: 整数,相加后的时间值
实 例: ret = !TimeAdd(Time,500),ret为时间值Time加500秒后的值