# Timestamp スクリプトおよびチャート関数 TimeStamp() は、書式文字列が提供されている場合を除き、データ ロード スクリプトのシステム変数またはオペレーティング システムのタイムスタンプ書式設定を使用して、数式を日付と時刻の値として書式設定します。 構文: Timestamp(number[, format]) 戻り値データ型： デュアル 引数 | 引数 | 説明 | | --- | --- | | number | 書式設定する数値。 | | format | 結果として返される日付と時刻文字列の書式を設定する方法を記述する文字列。省略されている場合は、オペレーティング システムで設定された短い日付書式、時間書式、および小数点記号が使用されます。

`Timestamp` 関数は、さまざまな時間構造に対して多くの形式オプションをサポートしています。次に例を示します。

`DD/MM/YYYY`: 日付のみに焦点を当てます (例: `15/11/2024` )。

​`YYYY-MM-DD hh:mm:ss`: ​タイムスタンプのすべてを表示します (例: `2024-11-15 13:30:45`)。

`​MMM DD, YYYY`: ​月の略称と年全体を表示します (例: `Nov 15, 2024`)。

​`hh:mm:ss TT`: ​12 時間形式で時間のみを表示します (例: `01:30:45 PM`)

`​HH:mm:ss`: ​24 時間形式で時間を表示します (例: `13:30:45`)

`​wwww, MMM DD YYYY`: ​曜日と日付のすべてを表示します (例: `Friday, Nov 15 2024`)

`​YYYY-MM-DD hh:mm:ss.fff`: ​ミリ秒を含みます (例: `2024-11-15 13:30:45.123`​)。

[数値や日付書式の説明](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) | 例: チャートの数式 | 例 | 結果 | | --- | --- | | `Timestamp( 35648 )` | `TimestampFormat` が `YY-MM-DD hh:mm:ss` の場合は `97-08-06 00:00:00` を返します。 | | `Timestamp(35648,'YYYY-MM-DD hh.mm')` | 指定された形式が `YYYY-MM-DD hh.mm` の場合、`1997-08-06 00.00` を返します。 | | `Timestamp( 35648,'M/D/YYYY h:mm:ss[.fff] TT')` | 指定された形式が `M/D/YYYY h:mm:ss[.fff] TT` の場合、`8/6/1997 12:00:00 AM` を返します。 | | `Timestamp( 35648,'www, DD MMM YYYY hh:mm TT')` | 指定された形式が `www, DD MMM YYYY hh:mm TT` の場合、`Wed, 06 Aug 1997 12:00 AM` を返します。 | ## 例 - Timestamp の基本 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.htm) #### チャートの数式 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。 ロード スクリプトには次が含まれています: * 「`Example`」というデータ テーブルにロードされるデータセット。 * データ テーブル内の次の項目: * `TimeStampValue` * `YY-MM-DD hh:mm:ss` 形式を使用する `TimestampFormat` 変数。 ロード スクリプト ``` SET TimestampFormat='YY-MM-DD hh:mm:ss'; Example: Load * inline [ TimeStampValue 35648.375 35648 36648.875 36648.8756789 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、この項目を軸として追加します: * `TimeStampValue` 次のメジャーを作成します: * `=Timestamp(TimeStampValue)` は、システム設定を使用して値をタイムスタンプ形式で表示します。 * `=Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm')` は、関数で指定された形式を使用して、値をタイムスタンプ形式で表示します。 * `=Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT')` は、関数で指定された形式を使用して、値をタイムスタンプ形式で表示します。 * `=Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff')` は、関数で指定された形式を使用して、値をタイムスタンプ形式で表示します。 * `=Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT')` は、関数で指定された形式を使用して、値をタイムスタンプ形式で表示します。 * `=Timestamp(TimeStampValue,'wwww, MMM DD YYYY')` は、関数で指定された形式を使用して、値をタイムスタンプ形式で表示します。 結果テーブル | TimeStampValue | Timestamp(TimeStampValue) | Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm' | Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT') | Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff') | Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT') | Timestamp(TimeStampValue,'wwww, MMM DD YYYY') | | --- | --- | --- | --- | --- | --- | --- | | 35648 | 97-08-06 00:00:00 | 1997-08-06 00.00 | 8/6/1997 12:00:00 AM | 1997-08-06 00:00:00.000 | Wed, 06 Aug 1997 12:00 AM | Wednesday, Aug 06 1997 | | 35648.375 | 97-08-06 09:00:00 | 1997-08-06 09.00 | 8/6/1997 9:00:00 AM | 1997-08-06 09:00:00.000 | Wed, 06 Aug 1997 09:00 AM | Wednesday, Aug 06 1997 | | 36648.875 | 00-05-02 21:00:00 | 2000-05-02 21.00 | 5/2/2000 9:00:00 PM | 2000-05-02 21:00:00.000 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 | | 36648.8756789 | 00-05-02 21:00:58 | 2000-05-02 21.00 | 5/2/2000 9:00:58 PM | 2000-05-02 21:00:58.657 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 | 結果は、`TimestampFormat` 関数がさまざまな形式パラメーターを使用して値を表示する方法を示しています。 ## 例 - 異なる TimestampFormat 設定を使用した Timestamp の基本 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.htm) #### チャートの数式 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。 ロード スクリプトには次が含まれています: * 「`Example`」というデータ テーブルにロードされるデータセット。 * データ テーブル内の次の項目: * `TimeStampValue` * `YY-MM-DD hh:mm:ss` 形式を使用する `TimestampFormat` 変数。 ロード スクリプト ``` SET TimestampFormat='M/D/YY hh:mm:ss'; Example: Load * inline [ TimeStampValue 35648.375 35648 36648.875 36648.8756789 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、この項目を軸として追加します: * `TimeStampValue` 次のメジャーを作成します: * `=Timestamp(TimeStampValue)` は、システム設定を使用して値をタイムスタンプ形式で表示します。 * `=Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm')` は、関数で指定された形式を使用して、値をタイムスタンプ形式で表示します。 * `=Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT')` は、関数で指定された形式を使用して、値をタイムスタンプ形式で表示します。 * `=Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff')` は、関数で指定された形式を使用して、値をタイムスタンプ形式で表示します。 * `=Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT')` は、関数で指定された形式を使用して、値をタイムスタンプ形式で表示します。 * `=Timestamp(TimeStampValue,'wwww, MMM DD YYYY')` は、関数で指定された形式を使用して、値をタイムスタンプ形式で表示します。 結果テーブル | TimeStampValue | Timestamp(TimeStampValue) | Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm' | Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT') | Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff') | Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT') | Timestamp(TimeStampValue,'wwww, MMM DD YYYY') | | --- | --- | --- | --- | --- | --- | --- | | 35648 | 8/6/97 00:00:00 | 1997-08-06 00.00 | 8/6/1997 12:00:00 AM | 1997-08-06 00:00:00.000 | Wed, 06 Aug 1997 12:00 AM | Wednesday, Aug 06 1997 | | 35648.375 | 1997-08-06 9:00:00 | 1997-08-06 09.00 | 8/6/1997 9:00:00 AM | 1997-08-06 09:00:00.000 | Wed, 06 Aug 1997 09:00 AM | Wednesday, Aug 06 1997 | | 36648.875 | 5/2/00 21:00:00 | 2000-05-02 21.00 | 5/2/2000 9:00:00 PM | 2000-05-02 21:00:00.000 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 | | 36648.8756789 | 5/2/00 21:00:58 | 2000-05-02 21.00 | 5/2/2000 9:00:58 PM | 2000-05-02 21:00:58.657 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 | 結果は、`TimestampFormat` 関数がさまざまな形式パラメーターを使用して値を表示する方法を示しています。 ## 例 - 顧客注文のタイムスタンプ形式の変更 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.htm) #### チャートの数式 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。 ロード スクリプトには次が含まれています: * 「`Example`」というデータ テーブルにロードされるデータセット。 * データ テーブル内の次の項目: * `Customer` * `CustomerName` * `OrderTimestamp` ロード スクリプト ``` Example: Load * inline [ OrderID, CustomerName, OrderTimestamp 1, Alice, 2024-02-20 11:00:00 2, Bob, 2024-03-01 15:30:00 3, Charlie, 2024-04-12 09:45:00 4, David, 2024-05-21 21:10:00 5, Eve, 2024-06-30 14:25:00 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します: * `OrderID` * `CustomerName` 次のメジャーを作成します: * `=Timestamp(OrderTimestamp, 'WWWW, DD MMM YYYY hh:mm TT')`、注文のタイムスタンプを、曜日、日付、時刻を示す形式で表示します。 結果テーブル | OrderID | CustomerName | Timestamp(OrderTimestamp, 'WWWW, DD MMM YYYY hh:mm TT') | | --- | --- | --- | | 1 | Alice | Tuesday, 20 Feb 2024 11:00 AM | | 2 | Bob | Friday, 01 Mar 2024 03:30 PM | | 3 | Charlie | Friday, 12 Apr 2024 09:45 AM | | 4 | David | Tuesday, 21 May 2024 09:10 PM | | 5 | Eve | Sunday, 30 Jun 2024 02:25 PM | `Timestamp` 関数を使用すると、タイムスタンプ データは曜日および日付と時刻の新しい形式を含むようにフォーマットされます。