润乾报表-时间日期函数

时间日期函数

1.now()

函数说明： 获得系统此刻的日期时间

语法： now()

返回值： 日期时间

2.year()

函数说明： 从日期型数据中获得年信息

语法： year(dateExp)

参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss

返回值： 整数

示例：

例1：year(datetime2("19800227","yyyyMMdd")) 返回：1980

例2：year("1972-11-08 10:20:30") 返回：1972

例3：year(dateTime("2006-01-15 13:20:45")) 返回：2006

3.month()

函数说明： 取得指定日期所在的月份

语法： 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

4.monthbegin()

函数说明： 取得指定日期所在月的月首

语法： 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

5.monthend()

函数说明： 取得指定日期所在月的月末

语法： 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

6.day()

函数说明： 从日期型数据中获得该日在本月中是几号 语法： day(dateExp)

参数说明： dateExp 表达式，其结果必须为日期或中国日期时间格式的字符串

返回值： 整数

示例：

例1：day(datetime2("19800227","yyyyMMdd")) 返回：27

例2：day(dateTime(12345)) 返回：1

例3：day(dateTime("2006-01-15 10:20:30")) 返回：15

7.dayName()

函数说明： 从日期型数据中获得该日的星期名称

语法： 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") 返回：星期三

8.dateNo()

函数说明： 从日期型数据中，获得该日位于一个星期中的第几天，星期天返回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

9.hour()

函数说明： 从日期时间型数据中，获得当前时间位于一天中的第几个时辰

语法： 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

10.minute()

函数说明： 从日期时间型数据中，获得分钟的信息

语法： 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

11.second()

函数说明： 从日期时间型数据中，获得秒信息

语法： 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

12.weekbegin()

函数说明： 获得指定日期所在星期的星期天，这里认定星期天为一周的开始

语法： 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

13.weekend()

函数说明： 获得指定日期所在星期的星期六，这里认定星期六为一周的结束

语法： 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

14.age()

函数说明： 计算两个时间间隔的整年数

语法：

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

15.daysAfter()

函数说明： 计算两个日期型数据相差几天 

语法： 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

16.secondsAfter()

函数说明： 计算两个日期时间型数据相差几秒

语法： 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

17.relDate()

函数说明： 从给定的日期型数据中，算出相差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

18.relTime()

函数说明： 从给定的日期时间型数据中，算出相差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

19.quaterbegin()

函数说明： 取得指定日期所在季度的首日

语法： 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

20.quaterend()

函数说明： 取得指定日期所在季度的末日

语法： 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

21.daysInYear()

函数说明： 获得指定日期所在年或者指定年份的天数

语法： 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

22.daysInMonth()

函数说明： 获得指定日期所在月的天数

语法： 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

23.lastday()

函数说明： 获得指定日期的上一天

语法： 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

24.lastmonth()

函数说明： 取得指定日期在上月的同日，若无同一日，则返回上月月末

语法： 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

25.lastyear()

函数说明： 取得指定日期在去年的同月同日，若无同月同日，则返回去年同月最后一天

语法： 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

26.time()

函数说明： 将字符串转换成时间型数据

语法： time(stringExp)

参数说明： stringExp HH:mm:ss格式的字符串

返回值： 时间型数据