4D Doc Center : データタイプ

4D v14.3

データタイプ

4Dのフィールド、変数、式は以下のデータタイプとなり得ます:

データタイプ	フィールド	変数	式
文字列 (*1)	○	○	○
数値 (*2)	○	○	○
日付	○	○	○
時間	○	○	○
ブール	○	○	○
ピクチャ	○	○	○
ポインタ	×	○	○
BLOB (*3)	○	○	×
配列 (*4)	×	○	×
Integer 64 bits (*5)	○	×	×
Float (*5)	○	×	×
オブジェクト (*6)	×	○	○
未定義	×	○	○

*1. 文字列には、文字フィールド、固定長変数、テキストフィールド、テキスト変数があります。
*2. 数値には、実数、整数、倍長整数のフィールドと変数があります。
*3. BLOBはBinary Large OBjectの省略形です。BLOBの詳細については、 BLOBコマンドの章を参照してください。
*4. 配列にはすべてのタイプの配列が含まれます。詳細については、配列の章を参照してください。
*5. Integer 64 bitsとFloatタイプは、SQLによってのみ管理されます。4D言語でこれらを使用することは推奨されません。これを行うと、これらのデータタイプは実数に変換され、精度が失われることがあります。
*6. オブジェクトを使用すると、ランゲージによって構築されたデータを操作できるようになります。オブジェクトはは "オブジェクト(ランゲージ)" テーマ内のコマンドによって管理できます。

文字列

文字列とは、以下を示す総称です:

文字フィールドまたは変数: 文字フィールドには0～255文字までの文字を格納することができます(上限はフィールドが定義されたときに設定されます)。
テキストフィールドまたは変数: テキストフィールド、変数、または式には0～2 GBのテキストを格納することができます。
任意の文字列またはテキスト式

文字列とテキスト変数には違いはありません。

文字列をテキストフィールドに割り当てることもできますし、その逆も可能です。4Dは必要に応じて変換・切り落としを自動的に行います。式の中で、文字列とテキストは混ぜて使用することが出来ます。

注: このマニュアルでは、コマンド説明における文字列とテキストの引数は特に明記されていない限り、両方とも「文字列」と表記されています。

数値

数値とは、以下を示す総称です。

実数のフィールド、変数、または式
整数のフィールド、変数、または式
倍長整数のフィールド、変数、または式

実数データタイプの範囲は、±1.7e±308 (15桁) です。
整数データタイプ（2バイト整数）の範囲は、-32,768..32,767 (2^15..(2^15)-1)です。
倍長整数データタイプ（4バイト整数）の範囲は、-2^31..(2^31)-1です。

数値データタイプは、異なる数値データタイプに代入することができます。このとき、4Dが必要に応じて変換、切り捨て、丸め処理を行います。ただし、値が範囲外の場合には、変換は正しい値を返しません。数値データタイプは式の中に混在させて使用することができます。

注: このマニュアルでは、実際のデータタイプに関わらず、コマンド説明における実数、整数、倍長整数の引数は特に明記されていない限り、数値と表記されています。

日付

日付フィールド、変数、式として認識できる範囲は、100/1/1から32,767/12/31までです。
日本語版の4Dを使用した場合、日付の順序は年/月/日の順になります。
年を2桁で指定され、30未満の場合2000年代であると解釈されます。30以上の場合は1900年代であると解釈されます。（このデフォルト設定は、SET DEFAULT CENTURYコマンドで変更できます）。

注: このマニュアルでは、コマンド説明における日付引数は特に明記されていない限り、「日付」と表記されています。

JavaScript の日付の変換

JavaScriptにおいて日付はオブジェクトなので、4Dに送られる際には他のオブジェクト同様、JSON フォームを含んだテキストとして送られます。この原理は特に4D Mobile または Webエリアを使用する際に適用されます。
JavaScript 日付の JSON フォームは ISO 8601規格に基づき、 "2013-08-23T00:00:00Z"のように記述されます。

このテキストは、デベロッパが4Dの日付(C_DATE) へと変換してあげる必要があります。方法は二つあります。:

JSON Parse コマンドを使用する方法:
C_TEXT($1) // 日付をISOフォーマットで受け取る C_DATE($d) $d:=JSON Parse("\""+$1+"\"";Is date))

Date コマンドを使用する方法:
C_TEXT($1) // 日付をISOフォーマットで受け取る C_DATE($d) $d:=Date($1)

二つの方法の違いに注意して下さい。 JSON Parse コマンドは SET DATABASE PARAMETER を使用して設定された変換モードに従うのに対し、 Date コマンドはこれに依存しないという事です。 Date コマンドを使用した変換は、常にローカルのタイムゾーンを考慮するということです。

時間

時間のフィールド、変数、式の範囲は00:00:00から596,000:00:00までです。
日本語版の4Dでは、時間の順序は時:分:秒の順になります。
時間は24時間制です。
時間の値は数値として扱うことができます。時間から返される数値は時間が表す秒数です。詳細はの節を参照してください。

注: このマニュアルでは、コマンド説明における時間引数は特に明記されていない限り、「時間」と表記されています。

ブール

ブールのフィールド、変数、式は、TRUE（真）またはFALSE（偽）のいずれかになります。

注: このマニュアルでは、コマンド説明におけるブール引数は特に明記されていない限り、「ブール」と表記されています。

ピクチャ

ピクチャのフィールド、変数、式は、任意のWindowsまたはMacintoshのピクチャになります。一般的に、ペーストボード上に置いたり、4Dコマンドやプラグインコマンドを使用してディスクから読み出すことのできる任意のピクチャがこれに含まれます。

注: このマニュアルでは、コマンド説明におけるピクチャ引数は特に明記されていない限り、「ピクチャ」と表記されています。

ポインタ

ポインタの変数または式は、別の変数（配列、配列要素を含む）、テーブルまたはフィールドへの参照です。ポインタタイプのフィールドは、存在しません。

ポインタの詳細については、の節を参照してください。

注: このマニュアルでは、コマンド説明におけるポインタ引数は特に明記されていない限り、「ポインタ」と表記されています。

BLOB

BLOBのフィールドまたは変数は、個別にまたはBLOBコマンドを使用して利用できる一連のバイト列（長さは0バイトから2ギガバイトまで）です。BLOBタイプの式は、存在しません。

注: このマニュアルでは、コマンド説明におけるBLOB引数は特に明記されていない限り、「BLOB」と表記されています。

Object

4D のネイティブなオブジェクトの構造は、よくある「値/名前」というペア(連想配列)に基づいています。これらのオブジェクトの記法は JSON のそれをもとにしていますが、完全に同じというわけではありません。

プロパティ名は必ずテキストで表現されます(例: "Name")。

プロパティ値は以下のどれかの型で表現されます:
- 番号(実数、整数、等)
- テキスト
- 配列(テキスト配列、実数配列、ブール配列、オブジェクト配列、ポインター配列)
- null
- ブール
- ポインター( JSON Stringify コマンドを使用して評価されたか、コピーされたときにポインターとして保存されます)
- 日付( "\"YYYY-MM-DDTHH:mm:ssZ\"" というフォーマットで表現されます)
- オブジェクト(オブジェクトを代入する階層の数に制限はありません)

オブジェクトはオブジェクト(ランゲージ) テーマ内のコマンドによって管理します。

データタイプ	文字列に変換	数値に変換	日付に変換	時間に変換
文字列		Num	Date	Time
数値 (*)	String
日付	String
時間	String
ブール		Num

(*) 時間値は数値として扱うことができます。

注: この表に示すデータ変換の他に、演算子と他のコマンドを組み合せることで、より洗練されたデータ変換を実行することができます。