[]
产品官网 帮助文档 API 文档 视频教程 技术社区
v9.0
在线Demo 免费试用
(Showing Draft Content)

日期时间函数

日期时间函数用于计算两个日期时间值之间的间隔，或者在一个日期时间值的基础上加上某个时间间隔，得到另一个日期时间值。

  • 表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

    返回表示指定年月日的日期时间值，其时间信息被设置为午夜 (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()，返回“2025/5/16 0:00:00”。

    Today()

    Weekday

    返回代表一星期中某天的整数。

    例如：Weekday(Today)返回7，表示星期六，如果返回1表示星期日。

    Weekday(<日期时间>[, <一周第一天>])

    WeekdayName

    返回某个整数（1-7）代表的星期几的名称。

    例如：当前日期是星期六时，WeekdayName(Weekday(Today))返回"星期六"。

    WeekdayName(<星期几的数字>[, <是否简写>[,

    <一周第一天>]])

    Quarter

    返回日期值的季度部分。

    Quarter(<DateTime>)

    QuarterName

    返回季度值的季度名称。

    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>])

  • 表2： 下面仅针对以下几个函数进行讲解

    函数

    说明

    Now/Today/Year/Quarter/Month/Day

    使用示例讲解函数用法，获取年季度月日

    QuarterName

    使用示例讲解函数用法，获取季度名称

    DateAdd

    使用示例讲解函数用法，时间偏移函数生成新日期

    DatePart

    使用示例讲解函数用法，日期要素提前函数