7.15.24. time_classify_day_of_week

7.15.24.1. 概要

バージョン 8.0.5 で追加.

指定された時刻の曜日を UInt8 の値として返します。 0 は日曜日で、 6 は土曜日です。

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

plugin_register functions/time

7.15.24.2. 構文

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

time_classify_day_of_week(time)

7.15.24.3. 使い方

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

実行例:

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

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

サンプルスキーマ:

実行例:

table_create  Memos TABLE_HASH_KEY ShortText
# [[0, 1337566253.89858, 0.000355720520019531], true]
column_create Memos created_at COLUMN_SCALAR Time
# [[0, 1337566253.89858, 0.000355720520019531], true]

サンプルデータ:

実行例:

load --table Memos
[
{"_key": "Sunday",    "created_at": "2018-07-01 00:00:00"},
{"_key": "Monday",    "created_at": "2018-07-02 00:00:00"},
{"_key": "Tuesday",   "created_at": "2018-07-03 00:00:00"},
{"_key": "Wednesday", "created_at": "2018-07-04 00:00:00"},
{"_key": "Thursday",  "created_at": "2018-07-05 00:00:00"},
{"_key": "Friday",    "created_at": "2018-07-06 00:00:00"},
{"_key": "Saturday",  "created_at": "2018-07-07 00:00:00"}
]
# [[0, 1337566253.89858, 0.000355720520019531], 7]

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

実行例:

select \
  --table Memos \
  --output_columns '_key, time_classify_day_of_week(created_at)'
# [
#   [
#     0,
#     1337566253.89858,
#     0.000355720520019531
#   ],
#   [
#     [
#       [
#         7
#       ],
#       [
#         [
#           "_key",
#           "ShortText"
#         ],
#         [
#           "time_classify_day_of_week",
#           null
#         ]
#       ],
#       [
#         "Sunday",
#         0
#       ],
#       [
#         "Monday",
#         1
#       ],
#       [
#         "Tuesday",
#         2
#       ],
#       [
#         "Wednesday",
#         3
#       ],
#       [
#         "Thursday",
#         4
#       ],
#       [
#         "Friday",
#         5
#       ],
#       [
#         "Saturday",
#         6
#       ]
#     ]
#   ]
# ]

日曜日の場合は 0 、月曜日の場合は 1 …、土曜日の場合は 6 を返します。

7.15.24.4. 戻り値

UInt8 で表現した曜日。有効な値は次の通りです。

曜日

0

日曜日

1

月曜日

2

火曜日

3

水曜日

4

木曜日

5

金曜日

6

土曜日