はじめに

このページではXC-Connectの
タグ設定の関数利用についてを説明します。

---

関数とは

XC-ConnectではXC-Gate.V3にデータを転送する際、タグ設定というものを行う必要があります。
そのタグ設定ではある項目で関数を使用し、データの形式を変換することが出来ますので、
今回はそれをご紹介いたします。
タグ設定の【項目の選択】画面になります。
ここの〖t〗の「number」には、データを登録した時間がエポックミリ秒で入っています。
エポックミリ秒とは、コンピューターシステム上での時刻表現になります。
しかしエポックミリ秒のデータ形式では視覚的に時間データと認識するのが難しくなります。
そこで関数を使うことによりこのエポックミリ秒のデータを普段使うデータ型に変換していきます。

---

関数の設定方法

タグ設定の【表示項目】もしくは【検索項目】に〖ｔ〗の「number」を追加します。
その後、【項目】に任意の関数を入力し、【プレビューを表示】を押下することでデータの変換を確認できます。

---

関数紹介

dateFmt(t)

この関数はエポックミリ秒をyyyy/MM/dd HH:mm:ssのフォーマットで文字型に変換します。
このようにエポックミリ秒で表示されるデータをyyyy/MM/dd HH:mm:ssのフォーマットで文字型に変換できます。

dateFloor(t,切り捨て単位秒)

この関数は切り捨て単位秒で指定した秒数単位でエポックミリ秒の切り捨てを行い、その値をグループ化します。
上図では切り捨て単位秒を2と入力しているので、2秒単位で切り捨てを行っていることが確認できます。
上図の場合であれば、20秒単位で取得データの集計を行うことが可能になります。

dateYear(t)

この関数はエポックミリ秒から年のみを取得します。

dateMonth(t)

この関数はエポックミリ秒から月のみを取得します。

dateDay(t)

この関数はエポックミリ秒から日付のみを取得します。

dateHour(t)

この関数はエポックミリ秒から時間のみを取得します。

dateMin(t)

この関数はエポックミリ秒から分のみを取得します。

dateSecond(t)

この関数はエポックミリ秒から秒のみを取得します。

toExcelDate(t)

この関数はエポックミリ秒をEXCEL日時シリアル値に変換します。
例えば、検索項目にてセルC2を上図のように指定します。
C2にはTODAY関数が入っています。
これをXC-Gate.V3に登録します。
するとこのようにtoExcelDate(t)を使ってデータの絞り込みを行うことが出来ます。

toXccDate()

この関数はEXCEL日時シリアル値をエポックミリ秒に変換します。
このような日付タグの入った帳票をXC-Connectから取得した際、シリアル値で表示されます。
その際、この関数を使うことでシリアル値をエポックミリ秒に変換することが出来ます。
ここでさらにdateFmt関数を使うことで、日付タグのデータをyyyy/MM/dd HH:mm:ssのフォーマットで文字型に変換できます。

dateParse()

この関数は日付文字列をエポックミリ秒に変換します。
yyyy/MM/dd HH:mm:ssのフォーマットで文字型として入力された日付データをエポックミリ秒に変換することが出来ます。

---

まとめ

以上、XC-Connectのタグ設定の関数を説明いたしました。
まずは、実際に設定してみて流れを掴んでいただけると幸いです。

---