【system.date】使用说明

对象：system.date

说明：提供一系列针对日期类型的操作

目录：

方法	返回	说明
system.date.isDate( date_string )	[True | False]	判断是否是日期类型
system.date.format( date_, format )	[String]	格式化日期
system.date.range( date, startDate, endDate )	[True | False]	判断日期是否在指定的区间范围内（date>=startDate And date<=endDate 时表示在区间内）
system.date.timestamp( time_, time_zone )	[Int]	获取时间戳
system.date.deTimestamp( intTime, intTimeZone )	[Date]	把时间戳转换为时间
system.date.now()	[Date]	获取当前服务器时间
system.date.getYear( date_string )	[Number]	获取日期年份值
system.date.getMonth( date_string )	[Number]	获取日期月份值
system.date.getDay( date_string )	[Number]	获取日期天值
system.date.getWeekDay( date_string )	[Number]	获取星期几，星期日返回1，星期一返回2，依次类推
system.date.getHour( date_string )	[Number]	获取日期小时值
system.date.getMinute( date_string )	[Number]	获取日期分钟值
system.date.getSecond( date_string )	[Number]	获取日期秒值
system.date.setYear( date_string, newYear )	[Date]	设置年并返回设置后的日期，此操作不会更改参数 date_string 值
system.date.setMonth( date_string, newMonth )	[Date]	设置月并返回设置后的日期，此操作不会更改参数 date_string 值
system.date.setDay( date_string, newDay )	[Date]	设置天并返回设置后的日期，此操作不会更改参数 date_string 值
system.date.setHour( date_string, newHour )	[Date]	设置小时并返回设置后的日期，此操作不会更改参数 date_string 值
system.date.setMinute( date_string, newMinute )	[Date]	设置分钟并返回设置后的日期，此操作不会更改参数 date_string 值
system.date.setSecond( date_string, newSecond )	[Date]	设置分钟并返回设置后的日期，此操作不会更改参数 date_string 值
system.date.yearDiff( date1, date2 )	[Number]	获取两个日期相差的年份，值可能是负值或0
system.date.monthDiff( date1, date2 )	[Number]	获取两个日期相差的月数，值可能是负值或0
system.date.dayDiff( date1, date2 )	[Number]	获取两个日期相差的天数，值可能是负值或0
system.date.hourDiff( date1, date2 )	[Number]	获取两个日期相差的小时，值可能是负值或0
system.date.minuteDiff( date1, date2 )	[Number]	获取两个日期相差的分钟，值可能是负值或0
system.date.secondDiff( date1, date2 )	[Number]	获取两个日期相差的秒，值可能是负值或0
system.date.yearAdd( date, num )	[Date]	获取增加年份后的日期
system.date.monthAdd( date, num )	[Date]	获取增加月份后的日期
system.date.dayAdd( date, num )	[Date]	获取增加天数后的日期
system.date.hourAdd( date, num )	[Date]	获取增加小时后的日期
system.date.minuteAdd( date, num )	[Date]	获取增加分钟后的日期
system.date.secondAdd( date, num )	[Date]	获取增加秒后的日期
system.date.setTimer( timer_name )	[无]	设置计时器
system.date.getTimer( timer_name )	[Int]	获取计时器耗时时间

方法：

原型：system.date.isDate( date_string )
说明：判断是否是日期类型
返回：[True | False]
参数：
        date_string     [必需 Date | String] 待检测的日期，类型可以是日期或日期格式的字符串

原型：system.date.format( date_, format )
说明：格式化日期
返回：[String]
参数：
        date_string     [必需 Date | String] 待格式化日期,类型可以是日期或日期格式的字符串
        format          [必需 yyyy-MM-dd hh:mm:ss] 格式样式，规则：yyyy-MM-dd hh:mm:ss，可根据需要设置规则

注意：非日期类型时返回原字符
示例：
        system.date.format( "2018-9-10 11:12:13", "yyyy/MM/dd" ) ' 结果 2018/09/10
        system.date.format( "2018-09-10 06:12:13", "yyyy/M/dd h:mm" ) ' 结果 2018/9/10 6:12

原型：system.date.range( date, startDate, endDate )
说明：判断日期是否在指定的区间范围内（date>=startDate And date<=endDate 时表示在区间内）
返回：[True | False]
参数：
        date         [必需 Date|String] 待判断的日期
        startDate    [必需 Date|String] 起始日期
        endDate      [必需 Date|String] 结束日期

时间戳类

原型：system.date.timestamp( time_, time_zone )
说明：获取时间戳
返回：[Int]
参数：
        time_        [可选 Date] 时间，不设置时表示当前服务器时间
        time_zone    [可选 Number] 时间对应的时区，不设置时默认时区值为 8
示例：
        system.date.timestamp() ' 结果为当前服务器时间的时间戳
        system.date.timestamp("2018-11-11 11:11") ' 结果为日期在时区8下的时间戳
        system.date.timestamp("2018-11-11 11:11", -5) ' 结果为日期在时间-5下的时间戳

原型：system.date.deTimestamp( intTime, intTimeZone )
说明：把时间戳转换为时间
返回：[Date]
参数：
        intTime        [必需 Number] 时间戳
        intTimeZone    [可选 Int] 时区，默认时区值8
示例：
        system.date.deTimestampe(1542771124) ' 表示还原时间戳在时区8下的时间
        system.date.deTimestampe(1542771124, 5) ' 表示还原时间戳在时间5下的时间

获取时间类

原型：system.date.now()
说明：获取当前服务器时间
返回：[Date]

原型：system.date.getYear( date_string )
说明：获取日期年份值
返回：[Number]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串

原型：system.date.getMonth( date_string )
说明：获取日期月份值
返回：[Number]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串

原型：system.date.getDay( date_string )
说明：获取日期天值
返回：[Number]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串

原型：system.date.getWeekDay( date_string )
说明：获取星期几
返回：[Number]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串

注意：星期日返回1，星期一返回2，依次类推

原型：system.date.getHour( date_string )
说明：获取日期小时值
返回：[Number]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串

原型：system.date.getMinute( date_string )
说明：获取日期分钟值
返回：[Number]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串

原型：system.date.getSecond( date_string )
说明：获取日期秒值
返回：[Number]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串

设置时间类

原型：system.date.setYear( date_string, newYear )
说明：设置年并返回设置后的日期，此操作不会更改参数 date_string 值
返回：[Date]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串
        newYear        [必需 Number] 新年份，值范围为1000-3000的整形数

原型：system.date.setMonth( date_string, newMonth )
说明：设置月并返回设置后的日期，此操作不会更改参数 date_string 值
返回：[Date]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串
        newMonth       [必需 Number] 新月份，值范围1-12的整形数

原型：system.date.setDay( date_string, newDay )
说明：设置天并返回设置后的日期，此操作不会更改参数 date_string 值
返回：[Date]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串
        newDay         [必需 Number] 新天数，值范围1-31的整形数

原型：system.date.setHour( date_string, newHour )
说明：设置小时并返回设置后的日期，此操作不会更改参数 date_string 值
返回：[Date]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串
        newHour        [必需 Number] 新小时，值范围0-23的整形数

原型：system.date.setMinute( date_string, newMinute )
说明：设置分钟并返回设置后的日期，此操作不会更改参数 date_string 值
返回：[Date]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串
        newMinute      [必需 Number] 新分钟，值范围0-59的整形数

原型：system.date.setSecond( date_string, newSecond )
说明：设置分钟并返回设置后的日期，此操作不会更改参数 date_string 值
返回：[Date]
参数：
        date_string    [必需 Date | String] 类型可以是日期或日期格式的字符串
        newSecond      [必需 Number] 新秒，值范围0-59的整形数

时间相差类

原型：system.date.yearDiff( date1, date2 )
说明：获取两个日期相差的年份，值可能是负值或0
返回：[Number]
参数：
        date1    [必需 Date] 日期或日期字符串类型
        date2    [必需 Date] 日期或日期字符串类型

原型：system.date.monthDiff( date1, date2 )
说明：获取两个日期相差的月数，值可能是负值或0
返回：[Number]
参数：
        date1    [必需 Date] 日期或日期字符串类型
        date2    [必需 Date] 日期或日期字符串类型

原型：system.date.dayDiff( date1, date2 )
说明：获取两个日期相差的天数，值可能是负值或0
返回：[Number]
参数：
        date1    [必需 Date] 日期或日期字符串类型
        date2    [必需 Date] 日期或日期字符串类型

原型：system.date.hourDiff( date1, date2 )
说明：获取两个日期相差的小时，值可能是负值或0
返回：[Number]
参数：
        date1    [必需 Date] 日期或日期字符串类型
        date2    [必需 Date] 日期或日期字符串类型

原型：system.date.minuteDiff( date1, date2 )
说明：获取两个日期相差的分钟，值可能是负值或0
返回：[Number]
参数：
        date1    [必需 Date] 日期或日期字符串类型
        date2    [必需 Date] 日期或日期字符串类型

原型：system.date.secondDiff( date1, date2 )
说明：获取两个日期相差的秒，值可能是负值或0
返回：[Number]
参数：
        date1    [必需 Date] 日期或日期字符串类型
        date2    [必需 Date] 日期或日期字符串类型

时间相加类

原型：system.date.yearAdd( date, num )
说明：获取增加年份后的日期
返回：[Date]
参数：
        date    [必需 Date] 日期或日期字符串类型
        num     [必需 Number] 增加数值

原型：system.date.monthAdd( date, num )
说明：获取增加月份后的日期
返回：[Date]
参数：
        date    [必需 Date] 日期或日期字符串类型
        num     [必需 Number] 增加数值

原型：system.date.dayAdd( date, num )
说明：获取增加天数后的日期
返回：[Date]
参数：
        date    [必需 Date] 日期或日期字符串类型
        num     [必需 Number] 增加数值

原型：system.date.hourAdd( date, num )
说明：获取增加小时后的日期
返回：[Date]
参数：
        date    [必需 Date] 日期或日期字符串类型
        num     [必需 Number] 增加数值

原型：system.date.minuteAdd( date, num )
说明：获取增加分钟后的日期
返回：[Date]
参数：
        date    [必需 Date] 日期或日期字符串类型
        num     [必需 Number] 增加数值

原型：system.date.secondAdd( date, num )
说明：获取增加秒后的日期
返回：[Date]
参数：
        date    [必需 Date] 日期或日期字符串类型
        num     [必需 Number] 增加数值

计时器类（可用于获取某一段后台程序运行耗时）

原型：system.date.setTimer( timer_name )
说明：设置计时器
参数：
        timer_name    [必需 String] 计时器名称

原型：system.date.getTimer( timer_name )
说明：获取计时器耗时时间
返回：[Date]
参数：
        timer_name    [必需 String] 计时器名称

注意：耗时单位是毫秒

计时器代码演示：

Call system.date.setTimer("tag") ' 设定计时器

' 程序代码段
For i=1 To 1000000
    Response.Write "  "
Next

' 结束时获取耗时
Response.Write "run time:" & system.date.getTimer("tag") & "ms!"