时间日期函数
函数说明: 计算两个时间间隔的整年数
语法:
age(dateExp1{,typeExp{, dateExp2}})
age(stringExp1,formatExp{,typeExp})
age(stringExp1,formatExp,typeExp,stringExp2)
参数说明:
dateExp1 日期型表达式,运算的结果是日期型(Date)
dateExp2 日期型表达式,运算的结果是日期型(Date),缺省为当前时间
stringExp1 表达式,其结果必须为日期或与formaetEXP一致的字符串
stringExp2 表达式,其结果必须为日期或格式与formaetEXP一致的字符串
formatExp 格式化表达式比如"yyyyMMdd","yyyy-MM-dd"等
typeExp 计算精确的最小单位 1为日,2为月,3为年,缺省为日
返回值: 整数
示例: 假设今天为2007.1.1
例1:age(datetime2("19800227","yyyyMMdd")) 结果为26
例2:age("19800227","yyyyMMdd",3) 结果为27
例3:age(date("1980-02-27"),,date("1999-02-27")) 结果为19
例4:age("1980-02-27","yyyy-mm-dd",,"1999-02-27") 结果为19
函数说明: 从日期型数据中获得该日在本月中是几号 语法: day(dateExp)
参数说明: dateExp 表达式,其结果必须为日期或中国日期时间格式的字符串
返回值: 整数
示例:
例1:day(datetime2("19800227","yyyyMMdd")) 返回:27
例2:day(dateTime(12345)) 返回:1
例3:day(dateTime("2006-01-15 10:20:30")) 返回:15
函数说明: 从日期型数据中获得该日的星期名称
语法: dayName(dateExp)
参数说明: dateExp 日期或标准日期格式的字符串,如:yyyy-MM-dd HH:mm:ss,yyyy-MM-dd,HH:mm:ss
返回值: 字符型
示例:
例1:dayName(datetime2("19800227","yyyyMMdd")) 返回:星期三
例2:dayName(dateTime(12345)) 返回:星期四
例3:dayName(dateTime("2006-01-15 10:20:30")) 返回:星期日
例4:dayName("12:14:34") 返回:星期四
例5:dayName("1972-11-08") 返回:星期三
例6:dayName("1972-11-08 10:20:30") 返回:星期三
函数说明: 从日期型数据中,获得该日位于一个星期中的第几天,星期天返回1,星期一返回2,依此类推
语法: dayNo(dateExp)
参数说明: dateExp 日期或标准日期格式的字符串,如:yyyy-MM-dd HH:mm:ss,yyyy-MM-dd,HH:mm:ss
返回值: 整数
示例:
例1:dayNo(dateTime2("19800227","yyyyMMdd")) 返回:4
例2:dayNo(dateTime("2006-01-15 10:20:30")) 返回:1
例3:dayNo("1972-11-08 10:20:30") 返回:4
函数说明: 计算两个日期型数据相差几天 语法: daysAfter(dateExp1, dateExp2)
参数说明: dateExp1 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss,yyyy-MM-dd,HH:mm:ss dateExp2 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss,yyyy-MM-dd,HH:mm:ss
返回值: 整数
示例:
例1:daysAfter(dateTime("1983-12-15 10:20:30"),datetime2("1982年12月30日","yyyy年MM月dd日")) 返回:-350
例2:daysAfter("1983-12-15 10:20:30","1982-12-30") 返回:-350
函数说明: 获得指定日期所在月的天数
语法: daysInMonth(dateExp)
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss,yyyy-MM-dd,HH:mm:ss
返回值: 整数
示例:
例1:daysInMonth(datetime2("19800227","yyyyMMdd")) 返回:29
例2:daysInMonth("1972-11-08 10:20:30") 返回:30
例3:daysInMonth(dateTime("2006-01-15 10:20:30")) 返回:31
函数说明: 获得指定日期所在年或者指定年份的天数
语法: daysInYear(dateExp) daysInYear(year)
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss,yyyy-MM-dd,HH:mm:ss year 返回整数的表达式
返回值: 整数
示例:
例1:daysInYear(datetime2("19800227","yyyyMMdd")) 返回:366
例2:daysInYear(dateTime("2006-01-15 10:20:30")) 返回:365
例3:daysInYear("1972-11-08 10:20:30") 返回:366
例4:daysInYear(2006) 返回:365
函数说明: 从日期时间型数据中,获得当前时间位于一天中的第几个时辰
语法: hour(datetimeExp)
参数说明: datetimeExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss,yyyy-MM-dd,HH:mm:ss
返回值: 整数
示例:
例1:hour("1983-12-15") 返回:0
例2:hour("1983-12-15 10:30:25") 返回:10
例3:hour(dateTime("2006-01-15 13:20:30")) 返回:13
函数说明: 获得指定日期的上一天
语法: lastday(dateExp)
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss,yyyy-MM-dd,HH:mm:ss
返回值: 日期时间型
示例:
例1:lastday("1972-11-08 10:20:30") 返回:1972-11-07 10:20:30
例2:lastday(datetime2("19800227","yyyyMMdd")) 返回:1980-02-26 00:00:00
例3:lastday(dateTime("2006-01-15 10:20:30")) 返回:2006-01-14 10:20:30
函数说明: 取得指定日期在上月的同日,若无同一日,则返回上月月末
语法: lastmonth( dateExp )
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss,yyyy-MM-dd,HH:mm:ss
返回值: 日期时间型
示例:
例1:lastmonth(datetime2("19800227","yyyyMMdd")) 返回:1980-01-27 00:00:00
例2:lastmonth("1972-11-08 10:20:30") 返回:1972-10-08 10:20:30
例3:lastmonth(dateTime("2006-01-15 10:20:30")) 返回:2005-12-15 10:20:30
函数说明: 取得指定日期在去年的同月同日,若无同月同日,则返回去年同月最后一天
语法: lastyear( dateExp )
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss,yyyy-MM-dd,HH:mm:ss
返回值: 日期时间型
示例:
例1:lastyear(datetime2("19800227","yyyyMMdd")) 返回:1979-02-27 00:00:00
例2:lastyear("1972-11-08 10:20:30") 返回:1971-11-08 10:20:30
例3:lastyear(dateTime("2006-01-15 10:20:30")) 返回:2005-01-15 10:20:30
函数说明: 从日期时间型数据中,获得分钟的信息
语法: minute(datetimeExp)
参数说明: datetimeExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
返回值: 整数
示例:
例1:minute(datetime2("19800227","yyyyMMdd")) 返回:0
例2:minute("1972-11-08 10:20:30") 返回:20
例3:minute(dateTime("2006-01-15 13:20:30")) 返回:20
函数说明: 取得指定日期所在的月份
语法: month(dateExp)
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
返回值: 整数
示例:
例1:month(datetime2("19800227","yyyyMMdd")) 返回:2
例2:month("1972-11-08 10:20:30") 返回:11
例3:month(dateTime("2006-01-15 13:20:30")) 返回:1
函数说明: 取得指定日期所在月的月首
语法: monthbegin( dateExp )
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
返回值: 日期时间型
示例:
例1:monthbegin(datetime2("19800227","yyyyMMdd")) 返回:1980-02-01 00:00:00
例2:monthbegin("1972-11-08 10:20:30") 返回:1972-11-01 10:20:30
例3:monthbegin(dateTime("2006-01-15 13:20:30")) 返回:2006-01-01 13:20:30
函数说明: 取得指定日期所在月的月末
语法: monthend( dateExp )
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
返回值: 日期时间型
示例:
例1:monthend(datetime2("19800227","yyyyMMdd")) 返回:1980-02-29 00:00:00
例2:monthend("1972-11-08 10:20:30") 返回:1972-11-30 10:20:30
例3:monthend(dateTime("2006-01-15 13:20:30")) 返回:2006-01-31 13:20:30
函数说明: 取得指定日期所在季度的首日
语法: quaterbegin( dateExp )
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
返回值: 日期时间
示例:
例1:quaterbegin(datetime2("19800227","yyyyMMdd")) 返回:1980-01-01 00:00:00
例2:quaterbegin("1972-11-08 10:20:30") 返回:1972-10-01 10:20:30
例3:quaterbegin(dateTime("2006-01-15 13:20:30")) 返回:2006-01-01 13:20:30
函数说明: 取得指定日期所在季度的末日
语法: quaterend( dateExp )
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
返回值: 日期时间
示例:
例1:quaterend(datetime2("19800227","yyyyMMdd")) 返回:1980-03-31 00:00:00
例2:quaterend("1972-11-08 10:20:30") 返回:1972-12-31 10:20:30
例3:quaterend(dateTime("2006-01-15 13:20:30")) 返回:2006-03-31 13:20:30
函数说明: 从给定的日期型数据中,算出相差n天后的新的日期数据
语法: relDate(dateExp, nExp)
参数说明: dateExp 给定的起始日期表达式,其结果必须为日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss nExp 整数表达式,需要求得nExp天后的新日期
返回值: 日期时间
示例:
例1:relDate(datetime2("19800227","yyyyMMdd"),5) 返回:1980-03-03 00:00:00
例2:relDate("1972-11-08 10:20:30",-10) 返回:1972-10-29 10:20:30
例3:relDate(dateTime("2006-01-15 13:20:30"),15) 返回:2006-01-30 13:20:30
函数说明: 从给定的日期时间型数据中,算出相差n秒后的新的日期时间数据
语法: relTime(datetimeExp, nExp)
参数说明: datetimeExp 给定的起始日期表达式,其结果必须为日期或标准日期格式的字符串,如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss nExp 整数表达式,需要求得nExp秒后的新日期时间
返回值: 日期时间
示例:
例1:relTime(datetime2("19800227","yyyyMMdd"),5) 返回:1980-02-27 00:00:05
例2:relTime("1972-11-08 10:20:30",-10) 返回:1972-11-08 10:20:20
例3:relTime(dateTime("2006-01-15 13:20:30"),15) 返回:2006-01-15 13:20:45
函数说明: 从日期时间型数据中,获得秒信息
语法: second(datetimeExp)
参数说明: datetimeExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
返回值: 整数
示例:
例1:second(datetime2("19800227","yyyyMMdd")) 返回:0
例2:second("1972-11-08 10:20:30") 返回:30
例3:second(dateTime("2006-01-15 13:20:45")) 返回:45
函数说明: 计算两个日期时间型数据相差几秒
语法: secondsAfter(datetimeExp1,datetimeExp2)
参数说明: datetimeExp1 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss datetimeExp2 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
返回值: 整数
示例:
例1:secondsAfter(datetime2("19800227","yyyyMMdd"),dateTime("1980-02-27 00:00:45")) 返回:45
例2:secondsAfter("1972-11-08 10:20:30","1972-11-08 10:30:50") 返回:620
函数说明: 获得指定日期所在星期的星期天,这里认定星期天为一周的开始
语法: weekbegin(dateExp)
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
返回值: 日期时间型
示例:
例1:weekbegin(datetime2("19800227","yyyyMMdd")) 返回:1980-02-24 00:00:00
例2:weekbegin("1972-11-08 10:20:30") 返回:1972-11-05 10:20:30
例3:weekbegin(dateTime("2006-01-15 13:20:45")) 返回:2006-01-15 13:20:45
函数说明: 获得指定日期所在星期的星期六,这里认定星期六为一周的结束
语法: weekend(dateExp)
参数说明: dateExp 日期或标准日期格式的字符串, 如:yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
返回值: 日期时间型
示例:
例1:weekend(datetime2("19800227","yyyyMMdd")) 返回:1980-03-01 00:00:00
例2:weekend("1972-11-08 10:20:30") 返回:1972-11-11 10:20:30
例3:weekend(dateTime("2006-01-15 13:20:45")) 返回:2006-01-21 13:20:45