4D View Pro セルフォーマット

4D v19

フォーマットパターンを定義することで、4D View Pro ドキュメントのコンテンツを想定通りに表示することができるようになります。4D View Pro には数値、日付、時間、そしてテキスト用のビルトインのフォーマットがありますが、独自のパターンを作成することで、特殊文字やコードを使用しているセルのコンテンツの表示も整えることができます。

例えば、請求書においてVP SET VALUE あるいは VP SET NUM VALUE コマンドを使用して金額を入力している場合、数値による空白とは関係なく(つまり金額が$5.00だろうと$5,000.00だろうと)通貨記号($, €, ¥, など) が同じ位置に並んで欲しいと思うことでしょう。この場合、フォーマット文字を使用してパターン _($* #,##0.00_) を指定することで、以下のように表示させることができます:

独自のフォーマットパターンを作成する場合、データの表示のみが変更されるという点に注意してください。データの値は変更されることなくそのまま残っています。

数値とテキストのフォーマット

数値フォーマットは全ての数値型(例:正の数、負の数、ゼロ)に対して適用されます。

文字	詳細	使用例
0	ゼロを表示するプレースホルダー	#.00 は1.1 を 1.10 と表示します。
.	小数点を表示します	0.00 は1999 を 1999.00 と表示します。
,	数値で千区切りのカンマを表示します。フォーマットに数値記号"#"あるいはゼロではさまれたカンマが含まれる場合、3桁ごとにカンマで区切られます。数値のプレースホルダーの後にくるカンマは1000までの数値となります。	#,0 は12200000 を 12,200,000 と表示します。
_	次の文字の幅をスキップします。	通常、カッコと組み合わせることで、左と右のインデントを追加します。具体的には _( と _) で指定します。
@	テキストのフォーマッター。セル内の全てのテキストにフォーマットを適用します。	"[Red]@" はテキスト値に対して赤のフォントカラーを適用します。
*	カラムの幅いっぱいまで次の文字を繰り返します。	0- は、数値の後にセルの幅いっぱいまでダッシュを繰り返します。対して、0 をフォーマットの前につけると、文字の先頭に0が複数つきます。
" "	引用符にはさまれたテキストを、何の解釈も加えることなく表示します。	"8%" は 8% と表示されます。
%	数字を百分率で表示します。	8% は、.08 として表示されます。
#	余分なゼロを表示しない桁のプレースホルダー。もし数値に、小数点の右側にプレースホルダーの数以上に桁があった場合、それらの数字は丸められます。	#.# は 1.54 を 1.5 として表示します。
?	余分なゼロのスペースを残すが、そのゼロは表示しない桁のプレースホルダー。通常、数値を小数点の位置で揃えるために使用されます。	$?? は最大で小数点以下2桁を表示し、$記号があるので異なる値が並ぶように指定します。
\	次に続く文字を表示します。	#.00\? は 123 を 123.00? として表示します。
/	数値に対して使用した場合、分数として表記します。テキスト、日付、タイムコードに対して使用した場合、それらをそのまま表示します。	#/# は .75 を 3/4 として表示します。
[ ]	条件つき書式を作成します。	[>100][GREEN]#,##0;[<=-100][YELLOW]#,##0;[BLUE]#,##0
E	指数表記のフォーマット。	#E+# - は 1,500,500 を 2E+6 として表示します。
[color]	テキストまたは数値を指定されたカラーにします。	[Green]###.##[Red]-###.###

例題 1

  //セルの値を$125,571.35 に設定

 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_($* #,##0.00_)")

日付と時間のフォーマット

4D View Pro ではIS0 8601 日付と時間パターンを示す以下の定数を提供しています:

定数	値	コメント
vk pattern full date time	"_fullDateTimePattern_"	カレントの言語設定におけるISO 8601 フォーマットの完全な日付と時間。アメリカでのデフォルトのパターン: "dddd, dd MMMM yyyy HH:mm:ss"
vk pattern long date	"_longDatePattern_"	カレントの言語設定におけるISO 8601 フォーマットの完全な日付。アメリカでのデフォルトのパターン: "dddd, dd MMMM yyyy"
vk pattern long time	"_longTimePattern_"	カレントの言語設定におけるISO 8601 フォーマットの時間。アメリカでのデフォルトのパターン: "HH:mm:ss"
vk pattern month day	"_monthDayPattern_"	カレントの言語設定におけるISO 8601 フォーマットの月日の日付。アメリカでのデフォルトのパターン: "MMMM dd"
vk pattern short date	"_shortDatePattern_"	カレントの言語設定における省略形のISO 8601 フォーマットの日付。アメリカでのデフォルトのパターン: "MM/dd/yyyy"
vk pattern short time	"_shortTimePattern_"	カレントの言語設定における省略形のISO 8601 フォーマットの時間。アメリカでのデフォルトのパターン: "HH:mm"
vk pattern sortable date time	"_sortableDateTimePattern_"	カレントの言語設定における、並べ替え可能なISO 8601 フォーマットの日付と時間。アメリカでのデフォルトのパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss"
vk pattern universal sortable date time	"_universalSortableDateTimePattern_"	UTCを使用した、並べ替え可能なISO 8601 フォーマットの日付と時間。アメリカでのデフォルトのパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'"
vk pattern year month	"_yearMonthPattern_"	カレントの言語設定における、ISO 8601 フォーマットの年月。アメリカでのデフォルトのパターン: "yyyy MMMM"

例題 2

  //セルの値を特定の日付と時間に設定する

 VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time";?14:30:10?;"format";vk pattern full date time))

カスタムの日付と時間のフォーマット

独自の日付と時間のパターンを、カレントの言語設定で作成したい場合、以下のコードを組み合わせて使用することができます:

	コード (大文字と小文字は区別しません)	詳細	使用例
日付			(January 1, 2019)
	m	先頭のゼロなしの月番号	1
	mm	先頭のゼロありの月番号	01
	mmm	短い月名	Jan
	mmmm	長い月名	January
	d	先頭のゼロなしの日番号	1
	dd	先頭のゼロありの日番号	01
	ddd	短い曜日名	Tue
	dddd	長い曜日名	Tuesday
	yy	短い年数	19
	yyyy	長い年数	2019

時間			(2:03:05 PM)
	h	先頭のゼロなしの時間。0-23の値	2
	hh	先頭のゼロありの時間。00-23の値	02
	m	先頭のゼロなしの分数。0-59の値	3
	mm	先頭のゼロありの分数。00-59の値	03
	s	先頭のゼロなしの秒数。0-59	5
	ss	先頭のゼロありの秒数。00-59	05
	[h]	経過時間の時間数	14 (24を超えることもある)
	[mm]	経過時間の分数	843
	[ss]	経過時間の秒数	50585
	AM/PM	午前か午後。省略された場合、24時間表記が使用されます。	PM

注: 'm' のコードはその位置とパターンに応じて解釈されます。'h' または 'hh' の直後、あるいは's' または 'ss' の直前に来た場合には分を表すと解釈されますが、それ以外の場合には月を表すと解釈されます。

追加の記号

上記で説明されている特殊文字とコードに加えて、フォーマットパターンに使用可能な追加の文字と記号があります。これらの追加の文字と記号は \ または "" を必要とせず、フォーマットパターンの解釈に影響することはありません。これらはパターン内において"そのまま"表示されます。

文字	詳細	使用例
+ および -	プラス記号およびマイナス記号	### + ### = ###,###
( )	左と右のカッコ記号	(-###.##)
:	コロン	hh:mm:ss
^	キャレット	#^#
'	アポストロフィー	'######
{ }	中カッコ	{###,###,###}
< >	未満、超える、の記号	## >##
=	等号	#+#=##
/	フォワードスラッシュ。数値で使用すると、数値を分数として表示します。	mm/dd/yyyy
!	感嘆符	$###.00!
&	アンパサンド	"Hello" & "Welcome"
~	チルダ	~##
	スペース文字
€	ユーロ	€###.00
£	英ポンド	£###.00
¥	日本円	¥###.00
$	ドル記号	$###.00
¢	セント記号	.00¢

参照

VP SET DATE TIME VALUE
VP SET DATE VALUE
VP SET FORMULA
VP SET NUM VALUE
VP SET TEXT VALUE
VP SET TIME VALUE
VP SET VALUE