# Time スクリプトおよびチャート関数
Time() は、書式文字列が提供されている場合を除き、データ ロード スクリプトのシステム変数またはオペレーティング システムの時刻書式設定を使用して、数式を時刻値として書式設定します。
構文:
Time(number[, format])
戻り値データ型： デュアル
引数
| 引数 | 説明 |
| --- | --- |
| number | 書式設定する数値。 |
| format | 結果として返される時刻文字列の書式を設定する方法を記述する文字列。省略されている場合は、オペレーティング システムで設定された時刻形式と小数点記号が使用されます。
`Time` 関数は、さまざまな時間構造に対して多くの形式オプションをサポートしています。次に例を示します。
`hh:mm:ss` - 時刻値を標準の時刻形式でフォーマットし、先頭にゼロを付けて、時間、分、秒を表示します。
`hh:mm TT` - AM/PM サフィックス付きの 12 時間形式を使用します。
`hh:mm` - 秒を省略し、時間と分のみを表示します。
`hh.mm.ss` - コロンの代わりにピリオド (`.`) を使用するなど、異なる区切り文字を使用した時刻形式。
`hh TT` - 時間と AM/PM のみが含まれます。
`hh "Hrs" mm "Mins"` - Hrs などのカスタムテキストで時間を表示します。
[数値や日付書式の説明](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |
例: チャートの数式
| 例 | 結果 |
| --- | --- |
| `Time( 0.375 )` | `TimeFormat` の設定が `'hh:mm:ss'` の場合、`09:00:00` を返します。 |
| `Time( 35648.375 )` | 指定された `Timeformat` が `'hh:mm:ss'` の場合は `09:00:00` を返します。 |
| `Time( 0.99999, 'hh-mm' )` | メジャーでフォーマットが指定されているため、`TimeFormat` 設定を無視して `23-59` を返します。 |
## 例 - Time の基本
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.htm)
#### チャートの数式
概要
データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。
ロード スクリプトには次が含まれています:
* 「`Example`」というデータ テーブルにロードされるデータセット。
* データ テーブル内の次の項目:
* `TimeValue`
* `hh:mm:ss` 形式を使用する `TimeFormat` 変数。
ロード スクリプト
```
SET TimeFormat='hh:mm:ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```
結果
データをロードしてシートを開きます。新しいテーブルを作成し、この項目を軸として追加します:
* ` TimeValue
`
次のメジャーを作成します:
* `=Time(TimeValue )`、システム設定を使用してフォーマットされた時刻として値を表示します。
* `=Time(TimeValue, 'hh-mm' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh:mm:ss' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh:mm TT' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh:mm' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh.mm.ss' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh TT' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )`、関数で指定された形式で値を時刻として表示します。
結果テーブル
| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
| 0.99999 | 23:59:59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 Hrs 59 Mins |
| 35648.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
結果は、`Time` 関数が関数式で指定された形式に基づいて値を表示する方法を示しています。
## 例 - 異なる TimeFormat 設定を使用した Time の基本
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.htm)
#### チャートの数式
概要
データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。
ロード スクリプトには次が含まれています:
* 「`Example`」というデータ テーブルにロードされるデータセット。
* データ テーブル内の次の項目:
* `TimeValue`
* `hh.mm.ss` 形式を使用する `TimeFormat` 変数。
ロード スクリプト
```
SET TimeFormat='hh.mm.ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```
結果
データをロードしてシートを開きます。新しいテーブルを作成し、この項目を軸として追加します:
* ` TimeValue
`
次のメジャーを作成します:
* `=Time(TimeValue )`、システム設定を使用してフォーマットされた時刻として値を表示します。
* `=Time(TimeValue, 'hh-mm' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh:mm:ss' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh:mm TT' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh:mm' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh.mm.ss' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh TT' )`、関数で指定された形式で値を時刻として表示します。
* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )`、関数で指定された形式で値を時刻として表示します。
結果テーブル
| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
| 0.99999 | 23.59.59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 Hrs 59 Mins |
| 35648.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
結果は、`Time` 関数が関数式で指定された形式に基づいて値を表示する方法を示しています。