getFormSubmitDate()

フォームの開始日、完了日または最終更新日のいずれかを取得します。

ノート:

ルールは、ターゲットまたはその他のルール・グローバル変数が更新および発行されるたびに実行されます。フォームの開始日、完了日または最終更新日をリアルタイムで更新する場合は、必要なすべての質問を変数として参照して、これらの質問のいずれかが更新されるたびにルールが実行されるようにしてください。

構文

getFormSubmitDate(param)

パラメータ

パラメータ 必須またはオプション 説明
param 必須
次のいずれかの値を持つことができる文字列値。
  • start: この値を使用して、フォームの開始日を取得します。
  • 完了: この値を使用して、必要なすべての質問がフォームで最初に回答された日付を取得します。
  • 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;
}

親トピック: フォーム、書式設定およびその他の関数