Skip to main content
`Ctrl`+`K`

# 7.15.29. `time_classify_day_of_week`

## 7.15.29.1. 概要

バージョン 8.0.5 で追加.

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

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

    plugin_register functions/time

## 7.15.29.2. 構文

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

    time_classify_day_of_week(time)

## 7.15.29.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.29.4. 戻り値

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

値 | 曜日
--- | ---
`0` | 日曜日
`1` | 月曜日
`2` | 火曜日
`3` | 水曜日
`4` | 木曜日
`5` | 金曜日
`6` | 土曜日