[]
日期时间函数用于计算两个日期时间值之间的间隔,或者在一个日期时间值的基础上加上某个时间间隔,得到另一个日期时间值。
表1 常用日期时间函数表
函数 | 说明 | 语法 |
---|---|---|
DateAdd | 返回一个 Date 值,其中包含添加指定时间间隔的日期和时间值。如DateAdd("d",-1,"2017-1-1") 返回值为"2016-12-31"。 | DateAdd(<时间单位>, <增减数值>, <日期时间表达式>) |
DateDiff | 返回一个 Long 值,该值指定两个 Date 值之间的时间间隔数。如DateDiff("y","2016-12-31","2017-1-1") 返回值为1,表示两个日期值之间的年份差值为1。 | DateDiff(<时间单位>, <日期时间值1>, <日期时间值2>[, <周内某天0-6>[, <年中某周1-53>]]) |
DatePart | 返回一个 Integer 值,其中包含给定 Date 值的指定部分(年,月,日,时,分,秒,毫秒,星期几等)。 如DatePart("m","2017-11-2")返回月份11。 | DatePart(<时间单位>, <日期时间值>[, <一周的第一天>[, <一年的第一周>]]) |
DateSerial | 返回表示指定年月日的 Date 值,其时间信息被设置为午夜 (00:00:00)。如DateSerial(2017,11,2)返回 "2017-11-2 00:00:00"。 | DateSerial(<年度数字>, <月份数字>, <日期数字>) |
DateString | 返回当前日期按当前区域设定中的日期格式显示的字符串,如"2000-12-31"。 | DateString() |
DateValue | 返回一个 Date 值,该值包含用字符串表示的日期信息,其时间信息设置为午夜 (00:00:00)。例如: DateValue("2012-12-31")。 | DateValue(<日期形式的字符串>) |
Day | 返回日期值的"日",例如:Day(DateValue("2013-4-5"))返回数值5。 | Day(<日期时间>) |
Hour | 返回时间值的小时部分。 | Hour(<日期时间>) |
Minute | 返回时间值的分钟部分。 | Minute(<日期时间>) |
Month | 返回日期值的月份部分。 | Month(<日期时间>) |
MonthName | 返回月份数的月份名称,例如:MonthName(3)返回"三月"。 | MonthName(<月份数字>[, <是否简写>]) |
Now | 返回当前的日期时间值。如Now()返回“2019/5/16 16:26:19”。 | Now() |
Second | 返回日期时间值的秒。例如:{Second(DateAdd("s",123,DateValue("2013-1-2")))} 这个表达式的结果 为3,原因是DateAdd函数返回的日期时间值是:2013-1-2 00:02:03,其中的秒就是3。 | Second(<日期时间>) |
TimeOfDay | 获取当前时间,无参数,返回值不带日期部分,显示为字符串形式为"0001/1/1 9:55:36"。 | TimeOfDay() |
Timer | 定时器函数,其内容为从0时到现在的时间,但单位是秒,如 36472.149871。 | Timer() |
TimeSerial | 返回一个 Date 值,该值表示指定的小时、分钟和秒,其日期信息设置基点为元年 1 月 1 日,如 TimeSerial(23,45,58)。 | TimeSerial(<小时数字>, <分钟数字>, <秒数字>) |
TimeString | 返回当前时间的字符串形式,如10:17:43。 | TimeString() |
TimeValue | 返回一个日期型数据的时间值。如TimeValue(Now())返回"0001/1/1 10:19:00"。 | TimeValue(<日期时间>) |
Today | 返回当前日期。如Today()返回“2019/5/16 0:00:00”。 | Today() |
Weekday | 返回代表一星期中某天的整数。如Weekday(Today)返回7,表示星期六,如果返回1表示星期日。 | Weekday(<日期时间>[, <一周第一天>]) |
WeekdayName | 返回某个整数(1-7)代表的星期几的名称,如当前日期是一个星期六时,WeekdayName(Weekday(Today)) 返回"星期六"。 | WeekdayName(<星期几的数字>[, <是否简写>[, <一周第一天>]]) |
Quarter | 返回日期值的季度部分 | Quarter(<DateTime>) |
Quarter Name | 返回季度值的季度名称。 | QuarterName(<DateTime>) |
Year | 返回一个日期值中的年度数值,如Year(Today())返回今年的年度值,如今天是2019年9月23日, 那么返回2019。 | Year(<日期时间>) |
AddYears | 在指定的日期时间基础上,再加/减指定的年数。比如,"2019/08/06".AddYears(2)将返回2021/08/06。 | <DateTime>.AddYears(<增减年数>) |
AddMonths | 在指定的日期时间基础上,再加/减指定的月数。比如,"2019/08/06".AddMonths(2)将返回2019/10/06。 | <DateTime>.AddMonths(<增减月数>) |
AddDays | 在指定的日期时间基础上,再加/减指定的天数。比如,"2019/08/06".AddDays(2)将返回2019/08/08; "2019/08/06".AddDays(-3)将返回2019/08/03。 | <DateTime>.AddDays(<增减天数>) |
AddHours | 在指定的日期时间基础上,再加/减指定的小时数。比如,"2019/08/06 15:28:02".AddHours(2) 将返回2019/08/06 17:28:02;"2019/08/06 15:28:02".AddHours(-3)将返回2019/08/06 12:28:02。 | <DateTime>.AddHours(<增减小时数>) |
AddMinutes | 在指定的日期时间基础上,再加/减指定的分钟数。 | <DateTime>.AddMinutes(<增减分钟数>) |
AddSeconds | 在指定的日期时间基础上,再加/减指定的秒数。比如,"2019/08/06 15:28:02".AddSeconds(2) 将返回2019/08/06 15:28:04。 | <DateTime>.AddSeconds(<增减秒数>) |
AddMilliseconds | 在指定的日期时间基础上,再加/减指定的毫秒数。 | <DateTime>.AddMilliseconds(<增减毫秒数>) |
DateTime.Parse | 将一个日期时间值,返回为指定的格式。示例:{DateTime.Parse("01/01/1970")} | DateTime.Parse(<格式字符串>[, <String>]) |