【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!"

 

posted @ 2018-11-21 11:33  1024记忆  阅读(2169)  评论(0编辑  收藏  举报