FindMinDateInRFs( )
フォームIDで識別されるフォームの全ての反復インスタンスで、指定日、日時、または部分的な日付項目の最小値を検索します。この関数は日付フィールドにのみ適用されます。
注意:
これは集計関数です。ターゲットが繰返しフォームにある場合は、各フォーム インスタンスに対してルールが実行されます。
構文
FindMinDateInRFs('variable', DateMask)
パラメータ
- 変数
-
ルール変数。参照パス:
eventId.formId.itemId
。注意:
この関数に渡された変数は、ルール式内の他の場所でも再使用できますが、一重引用符を使用して変数をパラメータとして追加する必要があります。 - DateMask
-
部分的な日付の処理方法を指定するフラグ。
null
.比較を行う際に日付の一部を無視します。- 値。部分日付のUNKコンポーネントを、指定した値に置き換えます。たとえば、
'10-Apr'
と入力すると、Day (DD)コンポーネントのUNK
値ごとに'10'
に置き換わり、Month (MMM)コンポーネントのUNK
値ごとに'Apr'
に置き換えられます。ノート:
マスクは日付要素にのみ使用し、時間要素には使用しないでください。時間部分の欠落値は00とみなされます。
戻り値
- 文字列形式の最小日付値。たとえば、
'27-Jan-2021 00:00'
です。 - 最小値が見つからない場合は
null
。
使用方法のヒント
- 部分的な日付値で不明な(
UNK
)値を置換するには、'DD-MON'
書式をDateMaskとして使用します。たとえば、マスクが'01-MAR'
の場合:日付値の一部 マスク日 ノート 'UNK-FEB-2020'
'01-FEB-2020'
マスクの day部分を使用した計算に有効になります。 'UNK-UNK-2020'
'01-MAR-2020'
マスクの日と月の両方を使用する計算に有効になります。 - 戻り値をJavaScript日付オブジェクトに変換するには、追加の書式設定を実行する必要があります。例:
vExample = '10-Jul-2022 10:UNK:UNK' new Date(vExample.replace(/UNK/g, "00"))
例3-46一連の繰返しフォーム・インスタンスにわたるアイテムの最小日付値の取得
// Get the minimum date value for an item across a set of repeating form instances
return FindMinDateInRFs('aeDate');
// Same as above, using a partial date field aeDate (UNK-MMM-YYYY)
return FindMinDateInRFs('aeDate', '01-JAN');
//to compare with another date
var maxd= FindMinDateInRFs('a');
var today = new Date();
var maxdate = new Date(maxd);
if(dateDiffInDays(today,maxdate)>0){
return "today>max";
}
return "today<max";
親トピック: 繰返しフォーム関数