@Now (式言語)

構文

@Now( flags ; serverNames )

パラメータ

flags

キーワードまたはキーワードリスト。オプション。

• [SERVERTIME]: serverNames が指定されていない場合はデータベースが存在するサーバーから日時を取得し、serverNames が指定されている場合は serverNames で指定されたサーバーから日時を取得します。
• [LOCALTIMEONERROR]: 指定されたサーバーから日時を取得するときにエラーが発生した場合は、ローカルコンピュータから日時を取得します。

serverNames

文字列または文字列リスト。オプション。サーバー名またはサーバー名のリストです。このパラメータは [SERVERTIME] を指定した場合に適用されます。

戻り値

now

日時または日時リスト。ローカルコンピュータ、現在のデータベースが存在するサーバー、または指定したサーバーの現在の日時です。次の「使用法」を参照してください。

使用法

@Now では、以下の場合にローカルコンピュータの日時が取得されます。

• パラメータが指定されていない。
• [SERVERTIME] が指定されているが、データベースがローカルで、serverNames が指定されていない。
• [LOCALTIMEONERROR] が指定され、serverNames が指定されたが、サーバーから日時を取得するときにエラーが発生した。

[SERVERTIME] を指定し、serverNames を指定しないとき、現在のデータベースが存在するサーバーの日時が取得されます。

[SERVERTIME] と serverNames を指定した場合は、指定したサーバーの日時が取得されます。

serverNames に指定したサーバーから時間を取得できない場合、[LOCALTIMEONERROR] を指定していなければエラーが発生します。

@Now を列式や選択式で使用すると、アプリケーションの処理効率が低下する場合があります。また、ビューの更新状態を示すマークが常に表示されるようになります。

@Now 関数は、1/100 秒の精度で現在の時間を返します。ただし、計算結果フィールドで現在の時間を指定するために @Now を使用すると、秒未満の値は常に秒単位に切り上げられるため、現在の時間が 1 秒進むことがあります。これを回避するには、@Now の代わりに次の式を使用します。

timenow := @Now;
@Date(@Year(timeNow);@Month(timeNow);@Day(timeNow);@Hour(timeNow);@Minute(timeNow);@Second(timeNow))

例

1. 次のフィールド値式では、1996 年 1 月 21 日午前 7 時 30 分 45 秒の場合、01/21/96 7:30:45 AM が返されます。

   @Now

2. 次のエージェントでは、Snapper と Tornado という 2 つのサーバーでの時間が表示されます。

   @Prompt([Ok];
   "Server time";
   @Implode("Snapper" : "Tornado" + " " +
   @Text(@Now([ServerTime] : [LocalTimeOnError];
   "Snapper" : "Tornado")); @Char(13)))

クロスリファレンス

LotusScript® 言語の Now 関数