7.15.29. time_classify_day

7.15.29.1. 概要

Added in version 6.0.3.

time_classify_day は時刻を日単位に丸めます。

これは、2020-01-30 11:50:11.000000 や 2020-01-30 22:50:11.000000 を 2020-01-30 00:00:00.000000 に丸めます。

この関数を有効にするには、以下のコマンドで functions/time プラグインを登録します。:

plugin_register functions/time

7.15.29.2. 構文

この関数の引数は1つです。:

time_classify_day(time)

7.15.29.3. 使い方

使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。

まず functions/time プラグインを登録します。

実行例:

plugin_register functions/time
# [[0,1337566253.89858,0.000355720520019531],true]

使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。

サンプルスキーマ:

実行例:

table_create Sales TABLE_NO_KEY
# [[0,1337566253.89858,0.000355720520019531],true]
column_create Sales name COLUMN_SCALAR ShortText
# [[0,1337566253.89858,0.000355720520019531],true]
column_create Sales price COLUMN_SCALAR UInt32
# [[0,1337566253.89858,0.000355720520019531],true]
column_create Sales timestamp COLUMN_SCALAR Time
# [[0,1337566253.89858,0.000355720520019531],true]

サンプルデータ:

実行例:

load --table Sales
[
{"name": "Apple" , "price": "256", "timestamp": "2020-05-01 11:50:11.000000"},
{"name": "Apple" , "price": "256", "timestamp": "2020-05-01 10:20:00.000000"},
{"name": "Orange", "price": "122", "timestamp": "2020-05-01 11:44:12.000001"},
{"name": "Apple" , "price": "256", "timestamp": "2020-05-01 19:50:23.000020"},
{"name": "Banana", "price": "88" , "timestamp": "2020-05-01 11:00:02.000000"},
{"name": "Banana", "price": "88" , "timestamp": "2020-05-01 21:34:12.000001"}
]
# [[0,1337566253.89858,0.000355720520019531],6]

以下は簡単な time_classify_day の使用例です。

実行例:

select \
  --table Sales \
  --output_columns 'name, time_classify_day(timestamp)'
# [
#   [
#     0,
#     1337566253.89858,
#     0.000355720520019531
#   ],
#   [
#     [
#       [
#         6
#       ],
#       [
#         [
#           "name",
#           "ShortText"
#         ],
#         [
#           "time_classify_day",
#           null
#         ]
#       ],
#       [
#         "Apple",
#         1588258800.0
#       ],
#       [
#         "Apple",
#         1588258800.0
#       ],
#       [
#         "Orange",
#         1588258800.0
#       ],
#       [
#         "Apple",
#         1588258800.0
#       ],
#       [
#         "Banana",
#         1588258800.0
#       ],
#       [
#         "Banana",
#         1588258800.0
#       ]
#     ]
#   ]
# ]

7.15.29.4. 引数

7.15.29.4.1. 必須引数

必須の引数は1つです。

7.15.29.4.1.1. column

対象のカラムを指定します。

7.15.29.5. 戻り値

日単位に丸めた時刻を返します。

戻り値はUNIX時間です。