Unix タイムスタンプ

概要

NocoBase では、Unix タイムスタンプ（Unix timestamp）を保存するために Unix タイムスタンプフィールドを使用します。

Unix タイムスタンプは、外部システムとの連携、ログデータ、過去データの移行などでよく使用されます。保存されるのは数値ですが、業務上の意味は時刻です。

外部システムから Unix タイムスタンプを要求されていない場合は、直接日付時刻を使用したほうが理解しやすく、メンテナンスも容易です。

適用シーン

Unix タイムスタンプは、次のような業務シーンに適しています。

外部システムとのタイムスタンプ同期
ログの発生時刻
API から返される Unix timestamp
過去データ移行時の時刻フィールド

作成時の設定

データテーブルの「Configure fields」ページで「Add field」をクリックし、「Unix タイムスタンプ」を選択すると、Unix タイムスタンプフィールドを作成できます。

20240512180432

設定	説明
Field interface	フィールドのインターフェースタイプ。Unix タイムスタンプには `unixTimestamp` が対応し、ページ上での入力方法と表示方法を決定します。
Field display name	画面上に表示されるフィールド名。たとえば「同期タイムスタンプ」「ログ時刻」「外部更新時刻」などです。業務担当者がすぐに理解できる名前を使用することをおすすめします。
Field name	API、リレーションフィールド、権限、ワークフローなどで内部参照するためのフィールド識別名です。作成後は通常変更せず、英字、数字、アンダースコアのみ使用でき、先頭は英字である必要があります。
Field type	データ層におけるフィールドの型。Unix タイムスタンプは通常、整数または長整数として保存します。
Default value	デフォルト値。新しいレコードを追加する際、ユーザーが入力しなければ自動的に設定できます。
Validation rules	バリデーションルール。必須入力や数値範囲を設定できます。
Description	フィールドの説明。フィールドの意味、入力要件、データソース、担当者などを記載するのに適しています。

注意

フィールド名は、作成後にページブロック、権限、ワークフロー、API から参照されます。作成前に命名を確認し、後から変更することで発生する設定調整の負担を避けてください。

フィールドの特性

Unix タイムスタンプフィールドのデフォルト動作は次のとおりです。

特性	説明
デフォルトの Field interface	`unixTimestamp`。
デフォルトの Field type	`bigInt`。
選択可能な Field type	`integer`、`bigInt`。
ページコンポーネント	編集モードでは、タイムスタンプフィールド用のコンポーネントとして処理されます。
フィルター	タイムスタンプの数値、または変換後の時間範囲でフィルタリングできます。
並べ替え	並べ替えに対応しています。
バリデーション	必須入力と数値範囲のバリデーションに対応しています。

設定の編集

作成後、フィールド右側の「Edit」をクリックすると、Unix タイムスタンプフィールドの設定を編集できます。フィールドの編集は主に、NocoBase でのフィールドの表示方法や使用方法を調整するために行います。たとえば、表示名、説明、デフォルト値、バリデーションルール、フィールド固有の設定などを変更できます。

フィールドがメインデータベースですでに同期されているテーブルに由来する場合、編集時には通常、フィールドマッピングを行います。つまり、データベースのフィールドを NocoBase の Field type と Field interface にマッピングします。

設定	編集可否	説明
Field display name	はい	画面上に表示されるフィールド名を変更します。フィールド識別名は変更されません。
Field name	いいえ	フィールド識別名は、作成後通常、編集フォームでは変更できません。
Field interface	条件付きで可	メインデータベースフィールドまたは同期フィールドは、フィールドマッピング時に調整できます。変更すると、ページ上での入力、表示、バリデーションの方法に影響します。
Field type	条件付きで可	メインデータベースフィールドまたは同期フィールドは、フィールドマッピング時に調整できます。変更前に、既存データを新しい型で利用できるか確認する必要があります。
Default value	はい	新しいレコードを追加する際のデフォルト値を調整します。
Validation rules	はい	フィールドのバリデーションルールを調整します。
Description	はい	フィールドの意味、入力要件、データソース、担当者などを補足します。

注意

Field type や Field interface の切り替えは、表示名を単純に変更することとは異なります。フィールドの保存方法、入力コンポーネント、バリデーションルール、フィルター条件、ワークフロー変数の使用方法に影響します。既存データが多い場合は、事前にデータ形式が適合するか確認してください。

フィールドの削除

フィールド右側の「Delete」をクリックすると、Unix タイムスタンプフィールドを削除できます。メインデータベースでは、複数のフィールドを選択して一括削除することもできます。

メインデータベースで新しく作成した Unix タイムスタンプフィールドを削除すると、通常、データベース内の実際の列と、その列に保存されているデータも同時に削除されます。データベースから同期したフィールドや外部データソースからマッピングしたフィールドを削除する場合の影響範囲は、対応するデータソースとフィールドの出所によって異なります。

警告

フィールドを削除すると、ページブロック、フォーム、フィルター、権限、ワークフロー、API、インポート・エクスポート、既存データに影響する可能性があります。削除前に、そのフィールドが業務上の設定から参照されていないか確認してください。

ページ設定での使用

Unix タイムスタンプフィールドは、外部システムとの連携やログ関連のシーンに適しています。 20260709232558

シーン	用途
フォームブロック	タイムスタンプの入力またはマッピング。
テーブルブロック	タイムスタンプの表示、並べ替え、フィルタリング。
ワークフロー	外部システムの時刻条件として使用。
API	Unix timestamp を要求する API との連携。

#Unix タイムスタンプ

#概要

#適用シーン

#作成時の設定

#フィールドの特性

#設定の編集

#フィールドの削除

#ページ設定での使用

#関連リンク