# Timestamp#スクリプトおよびチャート関数

Timestamp#() は、書式文字列が提供されている場合を除き、データ ロード スクリプトまたはオペレーティング システムのタイムスタンプ書式設定で、数式を日付と時刻の値として評価します。

構文:

timestamp#(text[, format])

戻り値データ型： デュアル

引数

| 引数 | 説明 |
| --- | --- |
| text | 評価対象のテキスト文字列。 |
| format | テキスト文字列を解釈するために使用する形式を記述する文字列。省略されている場合は、オペレーティング システムで設定された短い日付書式、時間書式、および小数点記号が使用されます。ISO 8601 は、タイムスタンプでサポートされています。<br><br>`Timestamp#` 関数は、さまざまな時間構造に対して多くの形式オプションをサポートしています。次に例を示します。<br><br>`DD/MM/YYYY`: 日付のみに焦点を当てます (例: `15/11/2024` )。<br><br>​`YYYY-MM-DD hh:mm:ss`: ​タイムスタンプのすべてを表示します (例: `2024-11-15 13:30:45`)。<br><br>`​MMM DD, YYYY`: ​月の略称と年全体を表示します (例: `Nov 15, 2024`)。<br><br>​`hh:mm:ss TT`: ​12 時間形式で時間のみを表示します (例: `01:30:45 PM`)<br><br>`​HH:mm:ss`: ​24 時間形式で時間を表示します (例: `13:30:45`)<br><br>`​wwww, MMM DD YYYY`: ​曜日と日付のすべてを表示します (例: `Friday, Nov 15 2024`)<br><br>`​YYYY-MM-DD hh:mm:ss.fff`: ​ミリ秒を含みます (例: `2024-11-15 13:30:45.123`​)。<br><br>[数値や日付書式の説明](https://help.qlik.com/ja-JP/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |

例: チャートの数式

| 例 | 結果 |
| --- | --- |
| `Timestamp#('12-03-2023 10:25:30', 'DD-MM-YYYY hh:mm:ss')` | `12-03-2023 10:25:30` を返します |
| `Timestamp#('2023/03/15 13:45', 'YYYY/MM/DD hh:mm')` | `2023/03/15 13:45` を返します |

## 例 - Timestamp# の基本

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/timestamp_hash.htm)

#### ロード スクリプト

概要

データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。

ロード スクリプトには次が含まれています:

* 「`Example`」というデータ テーブルにロードされるデータセット。

* データ テーブル内の次の項目:

  * `InputString`

* `Timestamp#` 関数を使用して式を日付と時刻の値として扱う先行ロード。実行すると、`TimeStamp_InputString` という追加項目が作成されます。

ロード スクリプト

```
SET DateFormat='M/D/YYYY'
Example:
Load *,
Timestamp(Timestamp#(InputString)) as TimeStamp_InputString;
LOAD * INLINE [
InputString
2015-09-15T12:13:14
1952-10-16T13:14:00+0200
1109-03-01T14:15
];
```

結果

データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します:

* ` InputString
                                       `

* `TimeStamp_InputString`

結果テーブル

| InputString | TimeStamp\_InputString |
| --- | --- |
| 1109-03-01T14:15 | 3/1/1109 2:15:00 PM |
| 1952-10-16T13:14:00+0200 | 10/16/1952 11:14:00 AM |
| 2015-09-15T12:13:14 | 9/15/2015 12:13:14 PM |

この例では、`Timestamp#` 関数を使用して文字列値をタイムスタンプとして評価する方法を確認できます。

## 例 - Timestamp# のシナリオ

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/timestamp_hash.htm)

#### ロード スクリプト

概要

イベント ログのデータには、使用しようとするタイムスタンプ形式が含まれています。

データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。

ロード スクリプトには次が含まれています:

* 「`Example`」というデータ テーブルにロードされるデータセット。

* データ テーブル内の次の項目:

  * `Event`
  * `EventDateTime`

* `Timestamp#` 関数を使用して、`EventDateTime` 項目の値をシステムが理解できる日付と時刻の形式に変換する先行ロード。実行すると、`EventTimestamp` という追加項目が作成されます。

ロード スクリプト

```
SET TimestampFormat='M/D/YYYY h:mm:ss[.fff] TT';
Example:
LOAD
Event,
EventDateTime,
Timestamp#(EventDateTime, 'DD-MM-YYYY hh:mm:ss') AS EventTimestamp
INLINE [
Event, EventDateTime
"Login", "12-03-2023 10:25:30"
"Logout", "12-03-2023 12:45:10"
"Login", "13-03-2023 09:10:15"
"Logout", "13-03-2023 17:30:20"
"Login", "14-03-2023 08:00:00"
];
```

結果

データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します:

* ` Event
                                       `

* `EventDateTime`

* `EventTimestamp`

次のメジャーを作成します:

* `=Timestamp(EventTimestamp)`、既定の設定としてロード スクリプトで指定された形式を使用してフォーマットされたタイムスタンプを表示します。

結果テーブル

| イベント | EventDateTime | EventTimestamp | Timestamp(EventTimestamp) |
| --- | --- | --- | --- |
| ログイン | 12-03-2023 10:25:30 | 12-03-2023 10:25:30 | 3/12/2023 10:25:30 AM |
| ログイン | 13-03-2023 09:10:15 | 13-03-2023 09:10:15 | 3/13/2023 9:10:15 AM |
| ログイン | 14-03-2023 08:00:00 | 14-03-2023 08:00:00 | 3/14/2023 8:00:00 AM |
| ログアウト | 12-03-2023 12:45:10 | 12-03-2023 12:45:10 | 3/12/2023 12:45:10 PM |
| ログアウト | 13-03-2023 17:30:20 | 13-03-2023 17:30:20 | 3/13/2023 5:30:20 PM |

この例では、`Timestamp#` 関数を使用して値を変換する方法を確認できます。