日時（タイムゾーンなし）

概要

NocoBase では、日時（タイムゾーンなし）（Date time without timezone） は、タイムゾーン変換を行わない日付と時刻を保存するために使用します。

日時（タイムゾーンなし）は、シフト、営業時間、授業時間など、ローカルでの表示値を重視する場面に適しています。

世界中で一貫した実際の時点を表す必要がある場合は、日時（タイムゾーンあり）のほうが適しています。

適用シーン

日時（タイムゾーンなし）は、次のような業務シーンに適しています。

ローカルのシフト時間
授業の開始時間、試験時間
店舗の営業時間
タイムゾーン変換を行いたくない業務上の時刻

作成時の設定

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

20260709232834

設定	説明
Field interface	フィールドのインターフェースタイプ。日時（タイムゾーンなし）には `datetimeNoTz` が対応し、ページ上での入力方法と表示方法を決定します。
Field display name	インターフェースに表示されるフィールド名。「シフト時間」「授業時間」「営業時間」などが該当します。業務担当者がすぐに理解できる名称を使用することをおすすめします。
Field name	API、リレーションフィールド、権限、ワークフローなどから内部参照するためのフィールド識別名です。作成後は通常変更せず、英字、数字、アンダースコアのみ使用でき、先頭は英字にする必要があります。
Field type	データ層におけるフィールドのタイプ。日時（タイムゾーンなし）では通常 `datetimeNoTz` を使用します。
Default value	デフォルト値。新しいレコードを追加する際にユーザーが入力しなかった場合、自動的にデフォルト値が入力されます。
Validation rules	検証ルール。必須入力や時間範囲などを設定できます。
Description	フィールドの説明。フィールドの意味、入力要件、データソース、管理担当者などを記載するのに適しています。

注意

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

フィールドの特性

日時（タイムゾーンなし）フィールドのデフォルト動作は次のとおりです。

特性	説明
デフォルトの Field interface	`datetimeNoTz`。
デフォルトの Field type	`datetimeNoTz`。
選択可能な Field type	`datetimeNoTz`。
ページコンポーネント	編集モードでは日時ピッカーを使用します。
フィルター	時点、範囲、空、空でない条件によるフィルタリングに対応します。
並べ替え	時刻による並べ替えに対応します。
検証	必須入力や時間範囲などの検証に対応します。

設定の編集

作成後、フィールド右側の「Edit」をクリックすると、日時（タイムゾーンなし）フィールドの設定を編集できます。フィールドの編集は主に、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」をクリックすると、日時（タイムゾーンなし）フィールドを削除できます。メインデータベースでは、複数のフィールドを選択して一括削除することもできます。

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

警告

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

ページ設定での使用

日時（タイムゾーンなし）フィールドは、ローカル時間を扱う業務に適しています。 20260709232511

シーン	用途
フォームブロック	日付と時刻を選択します。
テーブルブロック	時刻の表示、並べ替え、フィルタリングを行います。
カレンダーブロック	ローカルイベントの時刻フィールドとして使用します。
ワークフロー	時刻条件のフィールドとして使用します。

#日時（タイムゾーンなし）

#概要

#適用シーン

#作成時の設定

#フィールドの特性

#設定の編集

#フィールドの削除

#ページ設定での使用

#関連リンク