getFormSubmitDate()

检索表单的开始、完成或上次更新日期。

注：

只要更新并提交目标或任何其他规则全局变量，就会运行规则。如果要实时使用表单开始、完成或上次更新日期进行更新，请确保将所有必需的问题作为变量引用，以确保只要更新了其中任何问题，规则就会运行。

语法

getFormSubmitDate(param)

参数

参数 必需还是可选 说明
param 必需
可以具有以下值之一的字符串值：
  • start ：使用此值获取表单的开始日期。
  • completion（完成）：使用此值可获取首次以表单回答所有必需问题的日期。
  • lastupdate ：使用此值可获取上次更新表单的日期。

注：如果表单已清除或删除，然后重新输入数据，则开始和完成日期将分别返回最近开始或完成的日期。

返回值

返回日期，具体取决于提供的参数：
  • 表单开始日期。
  • 表单完成日期。
  • 表单上次更新日期。

    注：

    如果表单已恢复，对于上次更新的数据，此函数将返回表单恢复到再次更新时的日期。
日期始终在站点的本地时间中，基于为站点指定的时区，并且始终采用与系统日期相同的格式：ddd MMM DD YYYY HH:mm:ss GMT±hhmm (GMT±h)。例如 Thu May 08 2025 00:00:00 GMT+0000 (GMT)。

使用提示

  • 如果您打算将其中任何日期与与与主题对象关联的日期进行比较，请记住时区差异。与主题对象关联的日期将以 GMT 返回，而使用 getFormSubmitDate() 规则帮助函数检索的日期（以及任何站点输入的日期）始终在站点的本地时间中。
  • 如果使用 logMsg() 函数调试规则，则调试输出将显示使用 getFormSubmitDate() 规则帮助程序函数检索的日期的时间戳（以及站点输入的日期），其关联时区为 GMT。但是，这些日期始终在站点的本地时间。
  • 如果完成日期用作要填充问题的计算规则的返回，并且它是要更新的最后一个变量，则在更新表单上的另一个参考问题之前，不会返回完成日期。计算规则不能引用由计算规则填充的问题作为变量。

示例

示例 3-111 获取表单完成日期和任何其他日期之间的天数差异

var cDate = getFormSubmitDate('completion');
 
if(cDate!=null && testDate!=null)
{
    var res = dateDiffInDays(cDate,testDate);    //testDate may be, for example, the visit date as entered by the site user
    return res;
}

父主题：表单、格式设置和其他函数