@TimeMerge (式言語)

別々に指定された日付、時刻、タイムゾーンの値から日時値を作成します。

構文

@TimeMerge( date ; time ; timeZone )

パラメータ

date

日時値または日時リスト。新しい日時値に組み込む日付を指定します。

time

日時値または日時リスト。新しい日時値に組み込む時刻を指定します。

timeZone

String 型。オプション。新しい日時値に適用する正規のタイムゾーン値を指定します。この値は、タイムゾーンフィールドを使用して作成できます。

戻り値

Time-date

パラメータとして指定した日付、時刻、タイムゾーンから構成される新しい日時値または日時リストが返されます。

使用法

最初または 2 番目のパラメータがリストである場合、この関数はリストの要素に対して並列に処理され、戻り値は大きい方のリストと同じ数の要素を持つリストになります。

例

1. 次のコードをホットスポットボタンに追加すると、[date] フィールドの内容が 02/23/02 で [time] フィールドの内容が 17:45:00 ならば、[Merged date] ダイアログボックスに 02/23/2002 05:45:00 AM と表示されます。

   @Prompt([OK];"Merged date";@Text(@TimeMerge(date;time)))

2. 次のコードをフォームアクションに追加すると、[date] フィールドの内容が 02/23/02 02:30:00 で [time] フィールドの内容が 03/23/03 05:45:00 ならば、[Merged date] ダイアログボックスに 02/23/2002 05:45:00 AM と表示されます。

   @Prompt([OK];"Merged date";@Text(@TimeMerge(date;time)))

3. 次のコードをホットスポットボタンに追加すると、[date] フィールドの内容が 07/04/02、[time] フィールドの内容が 13:30:00、[zone] フィールドの内容が Z=11$DO=0$ZX=1$ZN=Samoa (GMT-11:00 として表示される) ならば、[Merged date] ダイアログボックスには 07/04/2002 08:30:00 PM と表示されます。時間は、指定されたタイムゾーンを反映するように調整されます。

   @Prompt([OK];"Merged date";@Text(@TimeMerge(date;time;zone)))

4. 次のコードの場合、01/01/2008 05:14 AM と 02/14/2008 07:45 PM がリストに表示されます。

   @TimeMerge([1:1:2008] : [2/14/2008]; [5:14 AM] : [7:45 PM])