Wordテンプレートの書式設定 - スタイルガイド
文書生成時には、日付の書式設定、テキストの大文字・小文字の変換、数値形式の適用など、動的に生成されるコンテンツに特定の書式設定を適用する必要がある場合があります。 PDF4me 生成される文書内でデータがどのように表示されるかを制御するための強力な書式設定機能を提供します。
基本的な書式設定構文
マージフィールドに書式を適用するための基本的な構文：
<<[token]:"format">>書式指定は、フィールド名の後にコロンで区切られ、引用符で囲まれて記述されます。
文字列の書式設定
以下の文字列書式設定オプションを使用して、テキストコンテンツを変換および書式設定します。
テキストの大文字小文字変換
大文字 文字列全体を大文字に変換します
構文： <<[token]:upper>>
例： <<[name]:upper>> →「ジョン・スミス」
単語の頭文字を大文字にする - すべての単語の最初の文字を大文字にします
構文： <<[token]:caps>>
例： <<[companyName]:caps>> → 「Pdf4me Solutions」
最初の文字を大文字にする - 文字列の最初の文字のみを大文字にします
構文： <<[token]:firstCap>>
例： <<[sentence]:firstCap>> →「これは文です。」
文字列フォーマットの例
テンプレート：
Customer Name: <<[customerName]:upper>>
Product Title: <<[productName]:caps>>
Description: <<[description]:firstCap>>
データ：
{
"customerName": "john smith",
"productName": "premium software package",
"description": "this is a premium product."
}
出力：
Customer Name: JOHN SMITH
Product Title: Premium Software Package
Description: This is a premium product.
日付と時刻の書式設定
日付と時刻の値をカスタムパターンでフォーマットして、お好みの形式で日付を表示します。
一般的な日付フォーマットパターン
日付と時間の詳細
構文： <<[token]:"dd MMM yy H:mm:ss">>
例： <<[date]:"dd MMM yy H:mm:ss">> → "2012年12月15日 10:10:21"
標準日付形式
構文： <<[token]:"dd-MM-yyyy">>
例： <<[invoiceDate]:"dd-MM-yyyy">> → 「2022年12月15日」
ヨーロッパの日付形式
構文： <<[token]:"dd.MM.yyyy">>
例： <<[invoiceDate]:"dd.MM.yyyy">> → 「2022年12月15日」
米国日付形式
構文： <<[token]:"MM/dd/yyyy">>
例： <<[date]:"MM/dd/yyyy">> → 「2022年12月15日」
ISO日付形式
構文： <<[token]:"yyyy-MM-dd">>
例： <<[date]:"yyyy-MM-dd">> → "2022-12-15"
長い日付形式
構文： <<[token]:"MMMM dd, yyyy">>
例： <<[date]:"MMMM dd, yyyy">> →「2022年12月15日」
時間のある短いデート
構文： <<[token]:"dd/MM/yyyy HH:mm">>
例： <<[timestamp]:"dd/MM/yyyy HH:mm">> → "2022/12/15 14:30"
日付フォーマットの例
テンプレート：
Invoice Date: <<[invoiceDate]:"dd.MM.yyyy">>
Due Date: <<[dueDate]:"MMMM dd, yyyy">>
Timestamp: <<[createdAt]:"dd MMM yy H:mm:ss">>
データ：
{
"invoiceDate": "2022/09/12",
"dueDate": "2022/10/12",
"createdAt": "2022/09/12 10:30:45"
}
出力：
Invoice Date: 12.09.2022
Due Date: October 12, 2022
Timestamp: 12 Sep 22 10:30:45
日付フォーマットの構成要素
日付フォーマットの構成要素を理解することで、カスタム日付フォーマットを作成できます。
| 成分 | 説明 | 例 |
|---|---|---|
d | 1日目～31日目 | 5, 15, 28 |
dd | 日付（1日～31日） | 05, 15, 28 |
M | 月（1～12） | 3, 9, 12 |
MM | 月（1～12） | 03, 09, 12 |
MMM | 月の略語 | Jan, Sep, Dec |
MMMM | 月のフルネーム | January, September, December |
yy | 年（2桁） | 22, 23 |
yyyy | 年（4桁） | 2022, 2023 |
H | 時（0～23時） | 0, 14, 23 |
HH | 時（0時～23時） | 00, 14, 23 |
h | 時（1～12時） | 1, 6, 12 |
hh | 時（1時～12時） | 01, 06, 12 |
m | 分（0～59） | 5, 30, 59 |
mm | 分（00～59） | 05, 30, 59 |
s | 2位（0-59） | 5, 30, 59 |
ss | 2番目（00-59） | 05, 30, 59 |
tt | 午前/午後 | AM, PM |
数値の書式設定
基本的な例では明示的に示されていませんが、数値の書式設定は同様のパターンに従います。
通貨形式:
Amount: <<[amount]:"C2">>
小数点以下の桁数：
Value: <<[value]:"F2">>
パーセンテージ:
Rate: <<[rate]:"P1">>
書式と式を組み合わせる
書式設定は、列挙メソッドや式と組み合わせることができます。
例：
Average Age: <<[employees.Average(p => p.Age)]:"F1">> years
Total Revenue: <<[orders.Sum(o => o.Total)]:"C2">>
Last Update: <<[updateDate]:"MMMM dd, yyyy 'at' HH:mm">>
実用例
請求書の例
テンプレート：
Invoice #: <<[invoiceNumber]:upper>>
Date: <<[invoiceDate]:"dd.MM.yyyy">>
Company: <<[companyName]:caps>>
Total Amount: $<<[totalAmount]:"F2">>
レポートヘッダーの例
テンプレート：
Report Generated: <<[generatedDate]:"MMMM dd, yyyy 'at' HH:mm:ss">>
Generated By: <<[userName]:caps>>
Period: <<[startDate]:"MMM yyyy">> - <<[endDate]:"MMM yyyy">>
ベストプラクティス
- 日付形式の一貫性 文書全体で同じ日付形式を使用する
- 地域的な考慮事項 - 対象読者に適した日付形式を選択してください
- テストの書式設定 - 生産前に実際のデータでフォーマットを確認する
- 文字列変換 読みやすさを維持するために、文字列の書式設定は慎重に適用してください。
- 数値精度 金額や数値には適切な小数点以下の桁数を使用してください。
:::ヒント：書式テスト 常に、null値、非常に長い文字列、異なる形式の日付など、特殊なケースを含むサンプルデータを使用して書式設定をテストし、出力の一貫性を確保してください。 :::