[]
示例 参考文档 主题编辑器 API文档
立即试用
(Showing Draft Content)

日期和时间函数

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

DateAdd

返回一个 Date 值，其中包含添加指定时间间隔的日期和时间值。

语法

DateAdd(<时间单位>, <增减数值>, <日期时间表达式>)

DateAdd(interval, number, date)

参数

  • interval 是一个字符串，用于设置您要添加的时间间隔。可能的值为：
    • yyyy - 年
    • q - 季度
    • m - 月
    • y - 一年中的某天
    • d - 天
    • w - 工作日
    • ww - 周
    • h - 小时
    • n - 分钟
    • s - 秒
  • number 是您要添加的间隔数。它可以是正数（以获取将来的日期）或为负数（以获取过去的日期）。
  • date 是添加间隔的日期。

示例

要在当前日期加上一年，可以使用以下表达式

{DateAdd("yyyy", 1, Now())}

返回一个 Date 值，其中包含添加指定时间间隔的日期和时间值。如{DateAdd("d",-1,"2017-1-1")}返回值为"2016-12-31"。

DateDiff

返回两个指定日期之间的时间间隔数。

语法

DateDiff(<时间单位>, <日期时间值1>, <日期时间值2>[, <周内某天0-6>[, <年中某周1-53>]])

DateDiff(interval, date1, date2, [ firstdayofweek, [ firstweekofyear ]] )

参数

  • interval 是一个字符串，用于设置您要添加的时间间隔。可能的值为：
    • yyyy - 年
    • q - 季度
    • m - 月
    • y - 一年中的某天
    • d - 天
    • w - 工作日
    • ww - 周
    • h - 小时
    • n - 分钟
    • s - 秒
  • number 是您要添加的间隔数。它可以是正数（以获取将来的日期）或为负数（以获取过去的日期）。
  • date 是添加间隔的日期。
  • date1, date2 - 您要在计算中使用的两个日期。
  • firstdayofweek 是用于指定一周中第一天的可选数字（Sunday = 1，Saturday = 7）。如果未指定，则假定为星期日。
  • firstweekofyear 是指定一年中第一周的可选数字。如果未指定，则假定第一周为1月1日所在的一周。可能的值为：
    • 1 - 从发生1月1日的星期开始
    • 2 - 从新的一年中至少有四天的第一周开始
    • 3 - 从一年的第一个完整星期开始。

示例

要比较下订单后多长时间寄出订单，您可以使用以下表达式

{DateDiff("d", ShipDate, OrderDate)}

返回一个 Long 值，该值指定两个 Date 值之间的时间间隔数。如:{DateDiff("y","2016-12-31","2017-1-1")}返回值为1，表示两个日期值之间的年份差值为1。

DatePart

返回一个 Integer 值，其中包含给定 Date 值的指定部分（年，月，日，时，分，秒，毫秒，星期几等）。

语法

DatePart(interval, date, [ firstdayofweek, [ firstweekofyear ]])

参数

  • interval 是一个字符串，用于设置您要添加的时间间隔。可能的值为：
    • yyyy - 年
    • q - 季度
    • m - 月
    • y - 一年中的某天
    • d - 天
    • w - 工作日
    • ww - 周
    • h - 小时
    • n - 分钟
    • s - 秒
  • date - 是您要返回其日期的日期。
  • firstdayofweek 是用于指定一周中第一天的可选数字（Sunday = 1，Saturday = 7）。如果未指定，则假定为星期日。
  • firstweekofyear是指定一年中第一周的可选数字。如果未指定，则假定第一周为1月1日所在的一周。可能的值为：
    • 1 - 从发生1月1日的星期开始
    • 2 - 从新的一年中至少有四天的第一周开始
    • 3 - 从一年的第一个完整星期开始。

示例

您可以使用以下表达式来显示版权符号以及当前年份

© {DatePart("yyyy", Now())}

返回一个 Integer 值，其中包含给定 Date 值的指定部分（年，月，日，时，分，秒，毫秒，星期几等）。如{DatePart("m","2017-11-2")}返回月份11。

DateSerial

返回指定年，月和日的日期。

语法

DateSerial(<年度数字>, <月份数字>, <日期数字>)

DateSerial(year, month, day)

参数

  • year - 100到9999之间的整数
  • month - 1到31之间的整数
  • day - 1到12之间的整数

示例

您可以使用以下表达式构造1982年1月4日

{DateSerial(1982, 1, 4)}

返回表示指定年月日的 Date 值，其时间信息被设置为午夜 (00:00:00)。如{DateSerial(2017,11,2)}返回"2017-11-2 00:00:00"。

DateString

以yyyy-mm-dd格式返回代表当前日期的字符串值。

语法

DateString()

DateValue

从指定的字符串返回日期。

语法

DateValue(<日期形式的字符串>)

DateValue(date)

参数

  • date -一个字符串，其中包含一个``yyyy-mm-dd```格式的日期。

示例

您可以使用以下表达式从``2020-02-29''字符串构造日期

{DateValue("2020-02-29")}

返回一个 Date 值，该值包含用字符串表示的日期信息，其时间信息设置为午夜 (00:00:00)。例如：{DateValue("2020-02-29")}。

Day

返回介于1到31之间（包括1和31）的数字，代表一个月中的某天。

语法

Day(<日期时间>)

Day(date)

参数

  • date - 您要返回其当月日期的日期

示例

您可以使用以下表达式显示当前日期的每月几号

{Day(Now())}

返回日期值的"日"，例如：{Day(DateValue("2013-4-5"))}返回数值5。

Hour

返回介于0到23之间（包括0和23）的数字，表示一天中的小时。

语法

Hour(<日期时间>)

Hour(date)

参数

  • date -您要返回其一天中的小时的日期

示例

您可以使用以下表达式显示当前日期的一天中的小时

{Hour(Now())}

Minute

返回介于0和59之间（包括0和59）的数字，表示小时的分钟数。

语法

Minute(<日期时间>)

Minute(date)

参数

  • date - 您要返回其分钟的日期

示例

您可以使用以下表达式来显示当前日期的分钟部分。

{Minute(Now())}

Month

返回1到12之间的一个数字（包括1和12），代表一年中的月份。

语法

Month(<日期时间>)

Month(date)

参数

  • date - 您要返回其当年月份的日期

示例

您可以使用以下表达式显示当前日期的一年中的月份

{Month(Now())}

MonthName

返回指示指定月份的字符串。

语法

MonthName(<月份数字>[, <是否简写>])

MonthName(month, [ abbreviate ])

参数

  • month -月份的数字名称。例如，一月是1，二月是2，依此类推。
  • abbreviate - 可选的布尔值，指示是否应缩写月份名称。默认为``false''

示例

您可以使用以下表达式显示当前月份的缩写

{MonthName(Month(Now()), true)}

返回月份数的月份名称，例如：{MonthName(3)}返回"三月"。

Now

返回当前日期和时间。

语法

Now()

Second

返回介于0到59之间（包括0和59）的数字，代表分钟的秒数。

语法

Second(<日期时间>)

Second(date)

参数

  • date - 您要返回其秒数的日期

示例

您可以使用以下表达式来显示当前日期时间的秒数

{Second(Now())}

返回日期时间值的秒。例如：{Second(DateAdd("s",123,DateValue("2013-1-2")))} 这个表达式的结果为3，原因是DateAdd函数返回的日期时间值是：2013-1-2 00:02:03，其中的秒就是3。

TimeOfDay

获取当前时间，无参数，返回值不带日期部分，显示为字符串形式为"0001/1/1 9:55:36"。

语法

TimeOfDay()

Timer

定时器函数，其内容为从0时到现在的时间，但单位是秒，如 36472.149871。

语法

Timer()

TimeSerial

返回一个 Date 值，该值表示指定的小时、分钟和秒，其日期信息设置基点为元年 1 月 1 日，如TimeSerial(23,45,58)。

语法

TimeSerial(<小时数字>, <分钟数字>, <秒数字>)

TimeSerial(hour, minute, second)

参数

  • hour - 0到23之间的整数
  • minute - 0到59之间的整数
  • second - 0到59之间的整数

示例

您可以使用以下表达式构造时间为下午3.30的日期

{TimeSerial(15, 30,0)}

TimeString

返回表示当前时间的字符串值。

语法

TimeString()

TimeValue

从指定的字符串返回时间值。

语法

TimeValue(<日期时间>)

TimeValue(time)

参数

  • time 一个字符串，其中包含12小时或24小时制的时间值。

示例

您可以使用以下表达式从3:15 am字符串构造时间

{TimeValue("3:15am")}

Today

返回当前日期。如Today()返回“2019/5/16 0:00:00”。

语法

Today()

Weekday

返回代表一星期中某天的整数。如Weekday(Today)返回7，表示星期六，如果返回1表示星期日。

语法

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

Weekday(date, [ firstdayofweek ])

参数

  • date - 您要返回其星期几的日期
  • firstdayofweek 是用于指定一周中第一天的可选数字（Sunday = 1，Saturday = 7）。如果未指定，则假定为星期日。

示例

您可以使用以下表达式显示当前工作日

{Weekday(Today())}

WeekDayName

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

语法

WeekdayName(<星期几的数字>[, <是否简写>[, <一周第一天>]])

WeekdayName(weekday, [abbreviate, [firstdayofweek ]])

参数

  • weekday - t星期几的数字名称。每天的数值取决于“ firstdayofweek”参数的设置。
  • abbreviate - 可选的布尔值，指示是否应缩写工作日名称。默认为``false''
  • firstdayofweek -是用于指定一周中第一天的可选数字（Sunday = 1，Saturday = 7）。如果未指定，则假定为星期日。

示例

您可以使用以下表达式显示星期几的缩写

{WeekDayName(Weekday(Now()), true)}

返回某个整数（1-7）代表的星期几的名称，如当前日期是一个星期六时，{WeekdayName(Weekday(Today))}返回"星期六"。

Quarter

返回一个数字，介于1和4之间（包括1和4），代表一年中的第四季度。

语法

Quarter(date)

参数

  • date - 您要返回其季度的日期的日期

示例

您可以使用以下表达式显示当前日期的一年的季度

{Quarter(Now())}

QuarterName

返回表示季度名称的字符串。

语法

QuarterName(date)

参数

  • date - 您要返回其季度名称的日期

示例

您可以使用以下表达式显示当前日期的季度名称

{QuarterName(Now())}

Year

返回代表年份的数字。

语法

Year(<日期时间>)

Year(date)

参数

  • date - 您要返回其年份的日期 示例

您可以使用以下表达式显示当前年份

{Year(Now())}

返回一个日期值中的年度数值，如Year(Today())返回今年的年度值，如今天是2019年9月23日，那么返回2019。