4D Doc Center : String

4D v13.4

String


String ( expression {; format {; addTime}} ) -> 戻り値

引数	型	説明
expression	式	文字列式を返したい式 (実数、整数、倍長整数、日付、時間、文字列、テキスト、ブールを指定可能)
format	文字, 倍長整数	表示フォーマット
addTime	時間	expressionが日付の時、文字列に追加する時間
戻り値	文字	式の文字列式

説明

Stringコマンドは、expressionに渡した数値、日付、時間、文字列、またはブールを文字列に変換します。

オプションのformatを指定しない場合、適当なデフォルトの形式で文字列が返されます。formatを指定すると、結果の文字列は指定した形式になります。

オプションのaddTime引数は、日付に時間を複合フォーマットで追加します。この引数はepression引数が日付型の時にのみ使用できます (後述)。

数値式
expressionが数値（実数、整数、倍長整数）である場合、オプションで文字列フォーマットを渡すことができます。次に例を示します。

例題	結果
String(2^15) `デフォルトフォーマットを使用	32768 (Default format used here)
String(2^15;"###,##0 Inhabitants")	32,768 Inhabitants
String(1/3;"##0.00000")	0.33333
String(1/3) `デフォルトフォーマットを使用	0.3333333333333330000 (Default format used here)
String(Arctan(1)*4)	3.141592653589790000 (Default format used here)
String(Arctan(1)*4;"##0.00")	3.14
String(-1;"&x")	0xFFFFFFFF
String(-1;"&$")	$FFFFFFFF
String(0 ?+ 7;"&x")	0x0080
String(0 ?+ 7;"&$")	$80
String(0 ?+ 14;"&x")	0x4000
String(0 ?+ 14;"&$")	$4000
String(50,3;"&xml")	50.3
String(Num(1=1);"True;;False")	True
String(Num(1=2);"True;;False")	False

フォーマットは、フォームの数値フォーマットと同じ方法で指定します。数値フォーマットの詳細については4D Design Referenceマニュアルの表示フォーマットを参照してください。カスタムフォーマットの書式名をformatに渡すことができます。カスタムフォーマットの名前は“|”で始めなければなりません。

日付式
expressionが日付の場合、デフォルトフォ－マット（YY.MM.DD）を使用して文字列が返されます。format 引数には、以下で説明する定数のいずれか１つを渡すことができます (Date Display Formatsテーマ) 。

この場合addTime引数に時間を渡すことができます。この引数を使用すれば日付と時間を合成し、標準形式のタイムスタンプを生成することができます (ISO Date、ISO Date GMT、Date RFC 1123定数)。このフォーマットはXMLやWebの処理の際特に有効です。addTime引数はexpressionが日付型の場合のみ使用できます。

定数	型	値	コメント
Blank if null date	倍長整数	100	0の代わりに""
Date RFC 1123	倍長整数	10	Fri, 10 Sep 2010 13:07:20 GMT
Internal date abbreviated	倍長整数	6	Dec 29, 2006
Internal date long	倍長整数	5	December 29, 2006
Internal date short	倍長整数	7	2006/12/29
Internal date short special	倍長整数	4	06/12/29 (しかし 1986/12/29 または 2096/12/29)
ISO Date	倍長整数	8	2006-12-29T00:00:00
ISO Date GMT	倍長整数	9	2010-09-13T16:11:53Z
System date abbreviated	倍長整数	2
System date long	倍長整数	3
System date short	倍長整数	1

互換性に関する注意: 4D v13.4以降、空の日付を System date short フォーマットの文字列へと変換した場合、フォームに返される結果は"!0000/00/00!" となります。以前のバージョンの4Dでは、この結果は年が2桁で返されていました("!00/00/00!")。

以下は今日が2006/12/29の場合の例です。

 $vsResult:=String(Current date) // $vsResultは"06/12/29"

 $vsResult:=String(Current date;Internal date long) // $vsResultは"December 29, 2006"

 $vsResult:=String(Current date;ISO Date GMT) // $vsResultは日本の場合"2006-12-28T15:00:00Z"

日付/時間複合フォーマットに関するメモ:

ISO Date GMTフォーマットはISO8601標準に対応します。日付と時間を含みタイムゾーン (GMT) を考慮します。
$mydate:=String(Current date;ISO Date GMT;Current time) // 2010-09-13T16:11:53Zを返します。

上記の例の最後の"Z"はGMTフォーマットの終了を表します。
addTime引数を渡さない場合、ローカルタイムの午前０時として扱いGMTに変換します (例題参照)。そのため日付がローカルタイムに対して前後することがあります。
$mydate:=String(Current date;ISO Date GMT) // 2010-09-12T15:00:00Zを返す
ISO DateフォーマットはISO Date GMTフォーマットと同様に日付と時間を含みますが、タイムゾーンを考慮しません。当初よりこのフォーマットはISO8601標準に準拠しておらず、非常に特殊な目的のために予約されたものです。
$mydate:=String(!13/09/2010!;ISO Date) // 2010-09-13T00:00:00 を返す（タイムゾーンに依存しない） &NBSP;&NBSP;&NBSP;&NBSP;$mydate:=String(Current date;ISO Date;Current time) // 2010-09-13T18:11:53 を返す
Date RFC 1123フォーマットは日付と時間の組み合わせをRFC 822と1123で定義された標準に基づきフォーマットします。このフォーマットはたとえばHTTPヘッダーでcookieの有効期限を設定する際に必要となります。
$mydate:=String(Current date;Date RFC 1123;Current time) // Fri, 10 Sep 2010 13:07:20 GMTを返す

表現される日時は、タイムゾーンが考慮されるためローカルのタイムゾーンにより日付が前後にずれることになります。日付のみを渡すと、コマンドはローカルタイムの00:00をGMT時間で表現して返します:
$mydate:=String(Current date;Date RFC 1123) // Thu, 09 Sep 2010 15:00:00 GMTを返す

時間式
expressionが時間の場合、デフォルトフォ－マット(HH:MM:SS)を使用して文字列が返されます。format 引数には、以下の表に示す定数のいずれか１つを渡すことができます (Time Display Formatsテーマ) 。

定数	型	値	コメント
Blank if null time	倍長整数	100	0の代わりに""
HH MM	倍長整数	2	01:02
HH MM AM PM	倍長整数	5	1:02 AM
HH MM SS	倍長整数	1	01:02:03
Hour Min	倍長整数	4	1時2分
Hour Min Sec	倍長整数	3	1時2分3秒
ISO Time	倍長整数	8	0000-00-00T01:02:03
Min Sec	倍長整数	7	62分3秒
MM SS	倍長整数	6	62:03
System time long	倍長整数	11	1:02:03 AM HNEC (Macのみ)
System time long abbreviated	倍長整数	10	1:02:03 AM (Macのみ)
System time short	倍長整数	9	01:02:03

Notes:

ISO DateフォーマットはISO8601標準に対応し、日付と時間を含みます。このフォーマットは日付と時間の複合をサポートしないため、日付部分は0で埋められます。このフォーマットはローカル時間を表します。
Blank if null定数はフォーマットに他のフォーマットに加算して使用しなければなりません。追加することにより、Null値の場合、4Dは0の代わりに空の文字列を返します。

以下の例は、現在時刻が5:30 PM45秒であるものとします。

 $vsResult:=String(Current time) // $vsResultは"17:30:45"

 $vsResult:=String(Current time;Hour Min Sec) // $vsResultは"17時30分45秒"

文字列式
expressionが文字列またはテキスト型の場合、コマンドは引数に渡した値と同じ値を返します。これは特にポインタを使用している汎用プログラミングで有効です。
この場合、format引数は渡されても無視されます。

ブール式
expressionがブール型の場合、コマンドはアプリケーションのランゲージに文字列 "True" または"False"を返します(例えば、4Dのフランス語バージョンでは、“Vrai”または“Faux”)。
この場合、format引数は渡されても無視されます。