フォーマット
進行中クエリの実行のたびに、各列にふさわしい表示形式と幅を自動で設定します。
フォーマットディレクティブは、1 つの列をどのように表示するか(数値、日付、ブール値、テキストなど)を記述するもので、クエリを実行するたびに適用されます。列ヘッダーを右クリックして、次を選択します フォーマット › フォーマットの上書きを設定… SQLly にコメントを書かせるか、好みに応じて手で入力します。
構文
-- sqlly format: column=<name>; <rule>[; <option>...][; width=<n>dp]
-- sqlly format: column=<name>; width=<n>dp
-- sqlly format:: 後ろにスペース -- と、直後のコロン format. --sqlly format: 適用されず、エディターが通知します。最初のセグメントは常に column=<name>。2 つ目はフォーマット規則で、 width=、またはその両方:
| ルール | 効果 | 例 |
|---|---|---|
number=N | 小数点以下 N 桁の固定小数点(次を反映 thousands=, style=)。小数点記号と桁区切り記号、負数の書式、配置は引き続き設定から取得され、列が省略表示されることはありません。 | number=2 |
date=P | 日付、日時、または日付のように見えるテキスト値を、列の表示タイムゾーンで strftime パターン P を使って表示します。日付として読み取れない値や、未知のトークンを含むパターンの場合、セルは送信されたままになります。 | date=%Y-%m-%d |
boolean=T/F | 真 / 偽の値に表示するテキスト。 | boolean=Yes/No |
binary= | バイナリ値を次の形式で表示する hex または base64. | binary=hex |
text= | 大文字・小文字の表記: upper, lower, title, none. | text=upper |
mask=P/S | 先頭P文字と末尾S文字を残して中間をマスクします。次の間は、コピーやエクスポートにも適用されます コピーとエクスポートにマスク書式を適用する がオンです。 | mask=0/4 |
epoch= | エポック整数から日付へ: auto, s、または ms. | epoch=s |
json=P | セルから JSON パスを抽出します。 | json=$.customer.name |
template=T | パイプヘルパー付きのテンプレートセル。 | template={value|upper} |
末尾のオプション: thousands=true|false そして style=fixed|percent|bytes 絞り込む number= ルール。 zone= は表示タイムゾーンを設定します date= または epoch= ルール(またはそれが唯一の設定の場合は、列の通常の日付表示用): UTC, local, stored (データベースから送られたまま。エポック値は UTC)、または次のようなタイムゾーン名 Europe/Berlin。列の上書き、接続、グローバル設定より優先されます。SQLly が認識しないタイムゾーン名があると、その行全体が無視されます。
-- sqlly format: column=created_at; epoch=s; zone=America/New_York
列の幅
width= 列の幅を設定します。行の唯一の設定にしても、ルールの隣に置いてもかまいません:
-- sqlly format: column=Notes; width=60dp
-- sqlly format: column=Total; number=2; width=40dp
単位は dp、グリッドのフォントに追従します。1 dp は結果グリッドのフォントサイズの 4 分の 1 です。グリッドのフォントが 10 pt の場合、 20dp は 50 ピクセルです。12 pt では同じ
20dp は 60 ピクセルです。そのためフォントサイズやズームを変更すると、列はテキストに合わせて伸縮し、表示できる文字数はほぼ同じに保たれます(1 文字あたり約 2.5 dp)。比例フォントでは文字ごとに幅が異なるため、これは正確な文字数ではなく近似です。 dp 接尾辞は省略可能:
width=40 意味します width=40dp.
ディレクティブで指定した幅は、ドラッグして SQLly が記憶した幅や自動サイズより優先されます。自動サイズはその列には作用しません。列を新しい幅にドラッグしても、次の実行時にディレクティブの幅に戻されます。新しい幅を維持するには、次をクリックします ロック
そして、SQLlyは次を書き換えます width= 自動で行われます。
1つの列に複数の行を指定
複数の format: 同じ列に対する行があると、それらはマージされます。後のルールは前のルールを置き換え、後の幅は前の幅を置き換えるため、次の 2 行は Total 小数 2 桁と 40 dp の幅:
-- sqlly format: column=Total; number=2
-- sqlly format: column=Total; width=40dp
例
-- sqlly format: column=Total; number=2
-- sqlly format: column=Qty; number=0; thousands=false
-- sqlly format: column=Created; date=%Y-%m-%d
-- sqlly format: column=IsActive; boolean=Yes/No
-- sqlly format: column=rate; number=1; style=percent
-- sqlly format: column=Card; mask=0/4
-- sqlly format: column=Notes; width=80dp
SELECT * FROM orders;


次を除くすべてのルール mask= グリッドの描画だけを変更します。コピーとエクスポートにはデータベース自身の値が使われます。参照: マスキング.
条件付き書式
format: 列内のすべての値をどのように書き出すかを決めます。セルを色付けするには
それらの 値 - 赤いテキストで表示されるのは Failed、負の残高の塗りつぶし、カラースケール、データバーには、次を使用します conditional: ディレクティブ、次の横に 1 行につき 1 つのルール format: 行。条件付き書式ダイアログを含む完全なガイドは 結果 › 条件付き書式.
-- sqlly format: column=Balance; number=2; width=36dp
-- sqlly conditional: column=Balance; when=< 0; fill=#FDE7E9
SELECT Account, Balance FROM ledger;