Simple Log Service:日付と時刻の関数

current_date 関数

current_date 関数は現在の日付を返します。戻り値は YYYY-MM-DD 形式です。

構文

current_date

戻り値の型

date 型。

例

前日のログをクエリします。

• クエリステートメント（デバッグ）

  * |
  SELECT
    *
  FROM  log
  WHERE
    __time__ < to_unixtime(current_date)
    AND __time__ > to_unixtime(date_add('day', -1, current_date))

• クエリと分析結果

current_time 関数

current_time 関数は現在の時刻とタイムゾーンを返します。戻り値は HH:MM:SS.Ms Time_zone 形式です。

構文

current_time

戻り値の型

time 型。

例

現在の時刻とタイムゾーンをクエリします。

• クエリステートメント（デバッグ）

  * | select current_time

• クエリと分析結果

current_timestamp 関数

current_timestamp 関数は現在の日付、時刻、およびタイムゾーンを返します。戻り値は YYYY-MM-DD HH:MM:SS.Ms Time_zone 形式です。

構文

current_timestamp

戻り値の型

timestamp 型。

例

前日のログをクエリします。

• クエリステートメント（デバッグ）

  * |
  SELECT
    *
  FROM  log
  WHERE
    __time__ < to_unixtime(current_timestamp)
    AND __time__ > to_unixtime(date_add('day', -1, current_timestamp))

• クエリと分析結果

current_timezone 関数

current_timezone 関数は現在のタイムゾーンを返します。

構文

current_timezone()

戻り値の型

varchar 型。

例

現在のタイムゾーンをクエリします。

• クエリステートメント（デバッグ）

  * | select current_timezone()

• クエリと分析結果

date 関数

date 関数は、日時式の日付部分を返します。この関数は cast(x as date) 関数と同じです。詳細については、「データ型変換関数」をご参照ください。

構文

date(x)

パラメーター

戻り値の型

date 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、date 関数を使用して現在の日付と時刻の日付部分を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp, date(current_timestamp)

• クエリと分析結果

date_format 関数

date_format 関数は、タイムスタンプ値を返すことができる日時式を、指定された形式の日時式に変換します。

構文

date_format(x, format)

パラメーター

戻り値の型

varchar 型。

例

NGINX リクエストのステータスをクエリし、NGINX リクエストの数を計算し、クエリと分析結果を時系列で表示します。これを行うには、date_trunc 関数を使用してログ時間を分単位で切り捨て、date_format 関数を使用して時間を %H:%i 形式に変換します。次に、分ごとのステータスコードごとのリクエスト数を計算し、クエリと分析結果をフローチャートに表示します。

• クエリステートメント（デバッグ）

  * |
  SELECT
    date_format(date_trunc('minute', __time__), '%H:%i') AS time,
    COUNT(1) AS count,
    status
  GROUP BY
    time,
    status
  ORDER BY
    time

• クエリと分析結果

date_parse 関数

date_parse 関数は、日時文字列を、タイムスタンプ値を返すことができ、指定された形式である日時式に変換します。

構文

date_parse(x, format)

パラメーター

戻り値の型

timestamp 型。

例

StartTime フィールドと EndTime フィールドの値を、タイムスタンプ値を返すことができる日時式に変換し、2 つの日時式の差を計算します。

• クエリステートメント

  *|
  SELECT
      date_parse(StartTime, '%Y-%m-%d %H:%i') AS "StartTime",
      date_parse(EndTime, '%Y-%m-%d %H:%i') AS "EndTime",
      date_diff('hour', StartTime, EndTime) AS "Time difference (hour)"

• クエリと分析結果

from_iso8601_date 関数

from_iso8601_date 関数は、ISO 8601 形式の日付式を、日付値を返すことができる日付式に変換します。戻り値は YYYY-MM-DD 形式です。

構文

from_iso8601_date(x)

パラメーター

戻り値の型

date 型。

例

time フィールドの値を、日付値を返すことができる日付式に変換します。

• サンプルフィールド

  time:2020-05-03

• クエリステートメント

  * | select from_iso8601_date(time)

• クエリと分析結果

from_iso8601_timestamp 関数

from_iso8601_timestamp 関数は、ISO 8601 形式の日時式を、タイムスタンプ値を返すことができる日時式に変換します。戻り値は YYYY-MM-DD HH:MM:SS.Ms Time_zone 形式です。

構文

from_iso8601_timestamp(x)

パラメーター

戻り値の型

timestamp 型。

例

time フィールドの値を、タイムスタンプ値を返すことができる日時式に変換します。

• サンプルフィールド

  time:2020-05-03T17:30:08

• クエリステートメント

  * | select from_iso8601_timestamp(time)

• クエリと分析結果

from_unixtime 関数

from_unixtime 関数は UNIX タイムスタンプを、タイムスタンプ値を返すことができる日時式に変換します。戻り値は YYYY-MM-DD HH:MM:SS.Ms または YYYY-MM-DD HH:MM:SS.Ms Time_zone 形式です。

構文

• 次の構文を使用すると、関数は UNIX タイムスタンプを、タイムスタンプ値を返すことができ、タイムゾーンを含まない日時式に変換します。

  from_unixtime(x)

• 次の構文を使用すると、関数は UNIX タイムスタンプを、タイムスタンプ値を返すことができ、タイムゾーンを含む日時式に変換します。

  from_unixtime(x,time zone)

• 次の構文を使用すると、関数は UNIX タイムスタンプを、タイムスタンプ値を返すことができ、タイムゾーンを含む日時式に変換します。日時式では、hours と minutes の値はタイムゾーンのオフセットを示します。

  from_unixtime(x, hours, minutes)

パラメーター

戻り値の型

timestamp 型。

例

time フィールドの値を、タイムスタンプ値を返すことができ、タイムゾーンを含む日時式に変換します。

• サンプルフィールド

  time:1626774758

• クエリステートメント

  * | select from_unixtime(time,'Asia/shanghai')

• クエリと分析結果

localtime 関数

localtime 関数はローカル時間を返します。戻り値は HH:MM:SS.Ms 形式です。

構文

localtime

戻り値の型

time 型。

例

ローカル時間をクエリします。

• クエリステートメント（デバッグ）

  * | select localtime

• クエリと分析結果

localtimestamp 関数

localtimestamp 関数はローカルの日付と時刻を返します。戻り値は YYYY-MM-DD HH:MM:SS.Ms Time_zone 形式です。

構文

localtimestamp

戻り値の型

timestamp 型。

例

前日のログをクエリします。

• クエリステートメント（デバッグ）

  * |
  SELECT
    *
  FROM  log
  WHERE
    __time__ < to_unixtime(localtimestamp)
    AND __time__ > to_unixtime(date_add('day', -1, localtimestamp))

• クエリと分析結果

now 関数

now 関数は現在の日付と時刻を返します。戻り値は YYYY-MM-DD HH:MM:SS.Ms Time_zone 形式です。この関数は current_timestamp 関数と同じです。

構文

now()

戻り値の型

timestamp 型。

例

前日のログをクエリします。

• クエリステートメント（デバッグ）

  * |
  SELECT
    *
  FROM  log
  WHERE
    __time__ < to_unixtime(now())
    AND __time__ > to_unixtime(date_add('day', -1, now()))

• クエリと分析結果

to_iso8601 関数

to_iso8601 関数は、日付またはタイムスタンプ値を返すことができる日時式を ISO 8601 形式の日時式に変換します。

構文

to_iso8601(x)

パラメーター

戻り値の型

varchar 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、to_iso8601 関数を使用して現在の日付と時刻を ISO 8601 形式に変換します。

• クエリステートメント（デバッグ）

  * | select to_iso8601(current_timestamp) AS ISO8601

• クエリと分析結果

to_unixtime 関数

to_unixtime 関数は、タイムスタンプ値を返すことができる日時式を UNIX タイムスタンプに変換します。

構文

to_unixtime(x)

パラメーター

戻り値の型

double 型。

例

前日のログをクエリします。

• クエリステートメント（デバッグ）

  * |
  SELECT
    *
  FROM  log
  WHERE
    __time__ < to_unixtime(now())
    AND __time__ > to_unixtime(date_add('day', -1, now()))

• クエリと分析結果

day 関数

day 関数は、日時式から月の何日目かを返します。この関数は day_of_month 関数と同じです。

構文

day(x)

パラメーター

戻り値の型

bigint 型。

例

current_date 関数を使用して現在の日付を取得します。次に、day 関数を使用して現在の日付に基づいて月の何日目かを返します。

• クエリステートメント（デバッグ）

  * | SELECT current_date, day(current_date)

• クエリと分析結果

day_of_month 関数

day_of_month 関数は、日時式から月の何日目かを返します。この関数は day 関数と同じです。

構文

day_of_month(x)

パラメーター

戻り値の型

bigint 型。

例

current_date 関数を使用して現在の日付を取得します。次に、day_of_month 関数を使用して現在の日付に基づいて月の何日目かを返します。

• クエリステートメント（デバッグ）

  * | SELECT current_date, day_of_month(current_date)

• クエリと分析結果

day_of_week 関数

day_of_week 関数は、日時式から曜日を返します。

構文

day_of_week(x)

パラメーター

戻り値の型

bigint 型。

例

current_date 関数を使用して現在の日付を取得します。次に、day_of_week 関数を使用して現在の日付に基づいて曜日を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_date, day_of_week(current_date)

• クエリと分析結果

day_of_year 関数

day_of_year 関数は、日時式から年の何日目かを返します。

構文

day_of_year(x)

パラメーター

戻り値の型

bigint 型。

例

current_date 関数を使用して現在の日付を取得します。次に、day_of_year 関数を使用して現在の日付に基づいて年の何日目かを返します。

• クエリステートメント（デバッグ）

  * | SELECT current_date, day_of_year(current_date)

• クエリと分析結果

dow 関数

dow 関数は、日時式から曜日を返します。この関数は day_of_week 関数と同じです。

構文

dow(x)

パラメーター

戻り値の型

bigint 型。

例

current_date 関数を使用して現在の日付を取得します。次に、dow 関数を使用して現在の日付に基づいて曜日を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_date, dow(current_date)

• クエリと分析結果

doy 関数

doy 関数は、日時式から年の何日目かを返します。この関数は day_of_year 関数と同じです。

構文

doy(x)

パラメーター

戻り値の型

bigint 型。

例

current_date 関数を使用して現在の日付を取得します。次に、doy 関数を使用して現在の日付に基づいて年の何日目かを返します。

• クエリステートメント（デバッグ）

  * | SELECT current_date, doy(current_date)

• クエリと分析結果

extract 関数

extract 関数は、日時式から指定された field を返します。フィールドは日付または時刻です。

構文

extract(field from x)

パラメーター

戻り値の型

bigint 型。

例

current_date 関数を使用して現在の日付を取得します。次に、extract 関数を使用して現在の日付の年を取得します。

• クエリステートメント（デバッグ）

  * | SELECT extract(year from current_date)

• クエリと分析結果

hour 関数

hour 関数は日時式から、1 日のうちの時間を返します。24 時間制が使用されます。

構文

hour(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、hour 関数を使用して現在の時刻に基づいて時間数を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp, hour(current_timestamp)

• クエリと分析結果

minute 関数

minute 関数は、日時式から時間の中の分を返します。

構文

minute(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、minute 関数を使用して現在の時刻に基づいて分数を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp, minute(current_timestamp)

• クエリと分析結果

month 関数

month 関数は日時式から年の何月かを返します。

構文

month(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、month 関数を使用して現在の日付に基づいて月を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp, month(current_timestamp)

• クエリと分析結果

quarter 関数

quarter 関数は指定した日付が属する四半期を返します。

構文

quarter(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、quarter 関数を使用して現在の日付が属する四半期を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp,quarter(current_timestamp)

• クエリと分析結果

second 関数

second 関数は日時式から分の中の秒を返します。

構文

second(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、second 関数を使用して現在の時刻に基づいて秒数を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp,second(current_timestamp)

• クエリと分析結果

timezone_hour 関数

timezone_hour 関数はタイムゾーンのオフセットを時間単位で返します。

構文

timezone_hour(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、timezone_hour 関数を使用して現在の時刻が属するタイムゾーンのオフセットを時間単位で取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp, timezone_hour(current_timestamp)

• クエリと分析結果

timezone_minute 関数

timezone_minute 関数はタイムゾーンのオフセットを分単位で返します。

構文

timezone_minute(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、timezone_minute 関数を使用して現在の時刻が属するタイムゾーンのオフセットを分単位で取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp,timezone_minute(current_timestamp)

• クエリと分析結果

week 関数

week 関数は、指定した日付が属する年の週番号を返します。この関数は week_of_year 関数と同じです。

構文

week(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、week 関数を使用して現在の日付が属する年の週番号を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp, week(current_timestamp)

• クエリと分析結果

week_of_year 関数

week_of_year 関数は、指定した日付が属する年の週番号を返します。この関数は week 関数と同じです。

構文

week_of_year(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、week_of_year 関数を使用して現在の日付が属する年の週番号を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp, week_of_year(current_timestamp)

• クエリと分析結果

year 関数

year 関数は指定した日付の年を返します。

構文

year(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、year 関数を使用して現在の日付の年を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp,year(current_timestamp)

• クエリと分析結果

year_of_week 関数

year_of_week 関数は、ISO 週日付システムで指定した日付が属する年を返します。この関数は yow 関数と同じです。

構文

year_of_week(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、year_of_week 関数を使用して、ISO 週日付システムで現在の日付が属する年を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp,year_of_week(current_timestamp)

• クエリと分析結果

yow 関数

yow 関数は ISO 週日付システムで指定した日付が属する年を返します。この関数は year_of_week 関数と同じです。

構文

yow(x)

パラメーター

戻り値の型

bigint 型。

例

current_timestamp 関数を使用して現在の日付と時刻を取得します。次に、yow 関数を使用して ISO 週日付システムで現在の日付が属する年を取得します。

• クエリステートメント（デバッグ）

  * | SELECT current_timestamp, yow(current_timestamp)

• クエリと分析結果

date_trunc 関数

date_trunc 関数は、指定した時間単位に基づいて日時式を切り捨てます。式はミリ秒、秒、分、時、日、月、または年単位で切り捨てることができます。この関数は、時間単位での統計分析が必要なシナリオでよく使用されます。

構文

date_trunc(unit, x)

パラメーター

* | SELECT count(1) AS pv,  __time__ - __time__ %300 AS time GROUP BY time LIMIT 100

戻り値の型

パラメーター値のデータ型と同じです。

例

リクエストの平均継続時間を分単位で計算します。次に、継続時間を時系列でグループ化してソートします。

• クエリステートメント（デバッグ）

  * |
  SELECT
    date_trunc('minute', __time__) AS time,
    truncate (avg(request_time)) AS avg_time,
    current_date AS date
  GROUP BY
    time
  ORDER BY
    time DESC
  LIMIT
    100

• クエリと分析結果

date_add 関数

date_add 関数は、日付または時刻に指定された間隔を加算または減算します。

構文

date_add(unit, n, x)

パラメーター

戻り値の型

timestamp 型。

例

前日のログをクエリします。

• クエリステートメント（デバッグ）

  * |
  SELECT
    *
  FROM  log
  WHERE
    __time__ < to_unixtime(current_timestamp)
    AND __time__ > to_unixtime(date_add('day', -1, current_timestamp))

• クエリと分析結果

date_diff 関数

date_diff 関数は、2 つの日付または時点の差を返します。

構文

date_diff(unit, x, y)

パラメーター

戻り値の型

bigint 型。

例

UsageStartTime フィールドと UsageEndTime フィールドに基づいてサーバーの実行時間を計算します。

• クエリステートメント

  * | SELECT  date_diff('hour', UsageStartTime, UsageEndTime) AS "Time difference (hour)"

• クエリと分析結果

time_series 関数

構文

time_series(x, window_time, format, padding_data)

パラメーター

戻り値の型

varchar 型。

例

2 時間の間に値が返されないフィールドに値 0 を追加します。

• クエリステートメント（デバッグ）

  * | select * from (select time_series(__time__, '2h', '%Y-%m-%d %H:%i:%s', '0') as time, count(*) as num from log group by time order by time) a limit 100

• クエリと分析結果

形式

単位