ago()
現在時刻から指定した時間間隔だけ前の日付を返します。
構文
ago(SPAN)
パラメーター
SPAN- 現在時刻から引く時間間隔を表す文字列です。数値と単位を続けて記述します。サポートする単位は次のとおりです。
| 単位 | 説明 |
|---|---|
s | 秒 |
m | 分 |
h | 時 |
d | 日 |
w | 週 |
mon | 月（1、2、3、4、6のみ許可） |
y | 年（1のみ許可） |
説明
ago() 関数は現在時刻 - SPANに対応する日付を返します。SPANはクエリのパース時点で一度計算されて固定されます。返却型はtimestampです。
エラーコード
パースエラー
| エラーコード | メッセージ | 説明 |
|---|---|---|
| 90500 | invalid-timespan | mon 単位に 1、2、3、4、6 以外の値を指定した場合 |
| 90501 | year should be 1 | y 単位に 1 以外の値を指定した場合 |
| 90502 | invalid time unit | サポートされていない時間単位を指定した場合 |
| 90503 | invalid timespan number [value] | 有効でない数値を指定した場合 |
ランタイムエラー
該当なし
使用例
これらの使用例で参照するWEB_APACHE_SAMPLEテーブルを準備するには、クエリ実習用データを参照してください。
-
1時間以内の最近のアクセスログのみを照会する
table WEB_APACHE_SAMPLE | search _time >= ago("1h") | fields _time, src_ip, uri, status -
7日以内の最近のアクセスログのみを照会する
table WEB_APACHE_SAMPLE | search _time >= ago("7d") | fields _time, src_ip, uri, status
互換性
ago() 関数はSonar 4.0以前のバージョンから提供されています。