日期时间函数

提示

日期时间的格式符：yyyy代表年，大写的MM代表月份，dd代表日，大写的HH表示24小时制，小写的hh表示12小时制，小写的mm表示分钟，ss代表秒，大写的SSS代表毫秒。

dateafter

函数说明：从给定的日期型数据中，算出相差n天后的新的日期数据

语法：dateafter(date, n)

参数说明：

date 给定的起始日期，可以是日期型数据，也可以是字符型数据，格式为：yyyy-MM-dd，yy-MM-dd
n 需要求得n天后的新日期

返回类型：日期

举例说明：

例1：dateafter(' 1992-2-3',5)，结果为：1992-2-8

dateDiff

函数说明：计算两个日期型数据的差值

语法：dateDiff(start_date,end_date[,unit])

参数说明：

start_date 起始日期
end_date 结束日期
unit 为所需信息的返回类型，"Y" 时间段中的整年数；"M" 时间段中的整月数；"D" 时间段中的天数；"YM"忽略日期中的日和年，计算月数的差；"YD"忽略日期中的年，计算天数的差；"MD"忽略日期中的月和年，计算天数的差。默认值是"D"

返回类型：整数

举例说明：

例1：dateDiff('2011-11-12','2012-12-25') 返回409；
例2：dateDiff('2011-11-12','2012-12-25','YD') 返回43；
例3：dateDiff('2011-11-12','2012-12-25','Y') 返回1；

day

注：该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明：从日期型数据中获得该日在本月中是几号

语法：day(dateExp)

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

返回类型：整数

举例说明：

例1：day('1996-8-9 12:30:01')，结果为：9
例2：day('1998-6-12')，结果为：12

dayname

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

语法：dayname(dateExp)

参数说明：date 需要获得星期名称的日期数据

返回类型：字符串

举例说明：

例1：dayname ('2009-8-22 12:30:01')，结果为：星期六
例2：dayname ('2009-8-10')，结果为：星期一

daynum

注：该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明：从日期型数据中，获得该日位于一个星期中的第几天，这里是将星期日作为一星期的第一天

语法：daynum(dateExp)

参数说明：date 需要获得星期信息的日期数据

返回类型：整数

举例说明：

例1：daynum ('2009-8-22 12:30:01')，结果为：7
例2：daynum ('2009-8-10')，结果为：2

Days360

函数说明：按照一年 360天的算法（每个月以 30天计，一年共计 12个月）计算两个日期型数据相差几天

语法：Days360(start_date,end_date[,Method])

参数说明：

start_date 起始日期
end_date 结束日期
Method 指定了在计算中是采用欧洲方法还是美国方法,取值如下：

false或忽略:美国方法 (NASD),如果起始日期是一个月的 31 号，则等于同月的 30 号。如果终止日期是一个月的 31号，并且起始日期早于 30 * 号，则终止日期等于下一个月的 1 号，否则，终止日期等于本月的 30 号。

true: 欧洲方法,无论是起始日期还是终止日期为一个月的 31 号，都将等于本月的 30 号

返回类型：整数

举例说明：

例1：days360('2011-1-29','2011-3-31') 返回 62
例2：days360('2011-1-29','2011-3-31',true) 返回61

dayscount

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

语法：dayscount(dateExp[,flag])

参数说明：

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

flag 年或月标识，标识要返回的是给定的日期的月的天数还是年的天数，取值为M和Y,默认是M

返回类型：整数

举例说明：

例1：dayscount("1972-11-08 10:20:30","M") 返回：30
例2：dayscount("1972-11-08 10:20:30","Y") 返回：366
例3：dayscount(todateTime("2006-01-15 10:20:30"),Y) 返回365
例4：dayscount(todateTime("2006-01-15 10:20:30"),M) 返回31

hour

注：该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明：从日期时间型数据中,获得当前时间的具体小时信息

语法：hour(datetime)

参数说明：datetime 需要获得时辰信息的时间型数据，也可为字符型数据，格式为：HH:mm:ss

返回类型：整数

举例说明：

例1：hour ('01:30:01')，结果为：1
例2：hour ('22:30:01')，结果为：22

lastday

注：该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明：获得指定日期的前一天(昨天)或前几天。

语法：lastday( dateExp {,rel})

参数说明：

dateExp 日期或标准日期格式的字符串，如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss
rel 间隔天数，不填的话，默认为-1

返回类型：日期

举例说明：

例1：lastday(todatetime("1980-02-27","yyyy-MM-dd")) 返回：1980-02-26
例2：lastday("1972-11-08 10:20:30") 返回：1972-11-07

lastmonth

注：该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明：取得指定日期在前一个月（或前几个月）的同日，若无同一日，则返回前一月（或前几个月）的月末

语法：lastmonth( dateExp {,rel})

参数说明：

dateExp 日期或标准日期格式的字符串，如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss
rel 间隔月份，不填的话，默认为-1

返回类型：日期

举例说明：

例1：lastmonth(todatetime("1980-02-27","yyyy-MM-dd")) 返回：1980-01-27
例2：lastmonth("1972-11-08 10:20:30") 返回：1972-10-08

lastyear

注：该函数支持excel公式导出、支持填报报表单元格自动计算

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

语法：lastyear( dateExp{,rel} )

参数说明：

dateExp 日期或标准日期格式的字符串，如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss
rel 间隔年份，不填的话，默认为-1

返回类型：日期

举例说明：

例1：lastyear(todatetime("1980-02-27","yyyy-MM-dd")) 返回：1979-02-27
例2：lastyear("1972-11-08 10:20:30") 返回：1971-11-08

minute

注：该函数支持excel公式导出、支持填报报表单元格自动计算

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

语法：minute(datetime)

参数说明：datetime 需要获得分钟信息的日期时间型数据，也可为字符型数据，格式为：HH:mm:ss

返回类型：整数

举例说明：

例1：minute ('01:30:01')，结果为：30
例2：minute ('01:00:01')，结果为：0

month

注：该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明：从日期型数据中，获得月的信息

语法：month(date)

参数说明：date 需要获得月信息的日期型数据，也可为字符型数据，格式为：如：yyyy-MM-dd HH:mm:ss、yy-MM-dd HH:mm:ss、yyyy-MM-dd 、yy-MM-dd

返回类型：整数

举例说明：

例1：month ('2008-9-5')，结果为：9
例2：month ('2008-3-30 12:5:8')，结果为：3

monthbegin

注：该函数支持excel公式导出、支持填报报表单元格自动计算

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

语法：monthbegin( dateExp )

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

返回类型：日期

举例说明：

例1：monthbegin(todatetime("1980-02-27","yyyy-MM-dd")) 返回：1980-02-01
例2：monthbegin("1972-11-08 10:20:30") 返回：1972-11-01

monthend

注：该函数支持excel公式导出、支持填报报表单元格自动计算

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

语法：monthend( dateExp )

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

返回类型：日期时间

举例说明：

例1：monthend(todatetime("1980-02-27","yyyy-MM-dd")) 返回：1980-02-29
例2：monthend("1972-11-08 10:20:30") 返回：1972-11-30 10:20:30

now

注：该函数支持excel公式导出、支持填报报表单元格自动计算

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

语法： now()

quaterbegin

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

语法：quaterbegin( dateExp )

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

返回类型：日期型

举例说明：

例1：quaterbegin(todatetime("1980-02-27","yyyy-MM-dd")) 返回：1980-01-01
例2：quaterbegin("1972-11-08 10:20:30") 返回：1972-10-01

quaterend

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

语法：quaterend( dateExp )

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

返回类型：日期型

举例说明：例1：quaterend(todatetime("1980-02-27","yyyy-MM-dd")) 返回：1980-03-31

second

注：该函数支持excel公式导出、支持填报报表单元格自动计算

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

语法：second(datetime)

参数说明：datetime 需要获得秒信息的日期时间型数据，也可为字符型数据，格式为：HH:mm:ss

返回类型：整数

举例说明：

例1：second ('01:30:01')，结果为：1
例2：second ('01:00:25')，结果为：25

timeafter

函数说明：从给定的日期时间型数据中，算出相差n秒后的新的日期时间数据

语法：timeafter(datetime, n)

参数说明：

datetime 给定的起始日期,也可为字符型数据，格式为：HH:mm:ss

n 需要求得n秒后的新日期时间,可以为负数

返回类型：时间

举例说明：

例1：timeafter('00:29:36', -4)，结果为：00:29: 32（这里调整显示格式为时间型）
例2：timeafter ('01:30:15',10 )，结果为：01:30:25（这里调整显示格式为时间型）

timeDiff

函数说明：计算两个时间型数据的差值

语法：timeDiff(datetime1,datetime2[,unit])

参数说明：

datetime1 起始时间
datetime2 结束时间
unit 为所需信息的返回类型，"H" 时间段中的整小时；"M" 时间段中的整分钟；"S" 时间段中的秒数；默认值是"S"

返回类型：整数

举例说明：

例1：timeDiff('1:12:00','2:00:12','M') 返回 48
例2：timeDiff('1:12:00','2:00:00') 返回 2880

weekbegin

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

语法：weekbegin(dateExp)

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

返回类型：日期时间

举例说明：

例1：weekbegin('2009-8-12 10:20:30')，结果为：2009-8-9（这里调整显示格式为日期型）
例2：weekbegin('2009-9-12 ')，结果为：2009-9-6（这里调整显示格式为日期型）

weekend

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

语法：weekend (dateExp)

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

返回类型：日期时间

举例说明：

例1：weekend ('2009-8-12 10:20:30')，结果为：2009-8-15（这里调整显示格式为日期型）
例2：weekend ('2009-9-12 ')，结果为：2009-9-12（这里调整显示格式为日期型）

year

注：该函数支持excel公式导出、支持填报报表单元格自动计算

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

语法：year(date)

参数说明：date 需要获得年信息的日期或标准日期格式的字符串，如：yyyy-MM-dd HH:mm:ss、yy-MM-dd HH:mm:ss、yyyy-MM-dd、yy-MM-dd

返回类型：整数

举例说明：

例1：year ('2009-8-12 10:20:30')，结果为：2009
例2：year ('1988-9-12 ')，结果为：1988
例3：year ('88-9-12 ')，结果为：1988
例4：year ('07-8-12 10:20:30')，结果为：2007