Formatação em Modelos do Word - Guia de Estilo
Durante a geração de documentos, pode ser necessário aplicar formatação específica ao conteúdo preenchido dinamicamente, como formatar datas, converter maiúsculas e minúsculas ou aplicar formatos de número. PDF4me Oferece recursos avançados de formatação para controlar a aparência dos dados nos documentos gerados.
Sintaxe básica de formatação
A sintaxe fundamental para aplicar formatação a campos de mesclagem:
<<[token]:"format">>A especificação de formato é colocada após o nome do campo, separada por dois pontos e entre aspas.
Formatação de strings
Transforme e formate o conteúdo do texto usando as seguintes opções de formatação de string:
Transformação de maiúsculas e minúsculas no texto
Maiúsculas - Converte toda a string para maiúsculas
Sintaxe: <<[token]:upper>>
Exemplo: <<[name]:upper>> → "JOHN SMITH"
Usar maiúsculas nas palavras - Coloca em maiúscula a primeira letra de cada palavra
Sintaxe: <<[token]:caps>>
Exemplo: <<[companyName]:caps>> → "Soluções Pdf4me"
Primeira letra maiúscula - Capitaliza apenas a primeira letra da sequência
Sintaxe: <<[token]:firstCap>>
Exemplo: <<[sentence]:firstCap>> → "Esta é uma frase."
Exemplos de formatação de strings
Modelo:
Customer Name: <<[customerName]:upper>>
Product Title: <<[productName]:caps>>
Description: <<[description]:firstCap>>
Dados:
{
"customerName": "john smith",
"productName": "premium software package",
"description": "this is a premium product."
}
Saída:
Customer Name: JOHN SMITH
Product Title: Premium Software Package
Description: This is a premium product.
Formatação de data e hora
Formate valores de data e hora usando padrões personalizados para exibir datas no formato de sua preferência.
Padrões comuns de formato de data
Data completa com hora
Sintaxe: <<[token]:"dd MMM yy H:mm:ss">>
Exemplo: <<[date]:"dd MMM yy H:mm:ss">> → "15 Dez 12 10:10:21"
Formato de data padrão
Sintaxe: <<[token]:"dd-MM-yyyy">>
Exemplo: <<[invoiceDate]:"dd-MM-yyyy">> → "15-12-2022"
Formato de data europeu
Sintaxe: <<[token]:"dd.MM.yyyy">>
Exemplo: <<[invoiceDate]:"dd.MM.yyyy">> → "15.12.2022"
Formato de data dos EUA
Sintaxe: <<[token]:"MM/dd/yyyy">>
Exemplo: <<[date]:"MM/dd/yyyy">> → "15/12/2022"
Formato de data ISO
Sintaxe: <<[token]:"yyyy-MM-dd">>
Exemplo: <<[date]:"yyyy-MM-dd">> → "2022-12-15"
Formato de data longo
Sintaxe: <<[token]:"MMMM dd, yyyy">>
Exemplo: <<[date]:"MMMM dd, yyyy">> → "15 de dezembro de 2022"
Encontro rápido com tempo
Sintaxe: <<[token]:"dd/MM/yyyy HH:mm">>
Exemplo: <<[timestamp]:"dd/MM/yyyy HH:mm">> → "15/12/2022 14:30"
Exemplo de formatação de data
Modelo:
Invoice Date: <<[invoiceDate]:"dd.MM.yyyy">>
Due Date: <<[dueDate]:"MMMM dd, yyyy">>
Timestamp: <<[createdAt]:"dd MMM yy H:mm:ss">>
Dados:
{
"invoiceDate": "2022/09/12",
"dueDate": "2022/10/12",
"createdAt": "2022/09/12 10:30:45"
}
Saída:
Invoice Date: 12.09.2022
Due Date: October 12, 2022
Timestamp: 12 Sep 22 10:30:45
Componentes do formato de data
Compreender os componentes do formato de data ajuda você a criar formatos de data personalizados:
| Componente | Descrição | Exemplo |
|---|---|---|
d | Dia (1-31) | 5, 15, 28 |
dd | Dia (01-31) | 05, 15, 28 |
M | Mês (1-12) | 3, 9, 12 |
MM | Mês (01-12) | 03, 09, 12 |
MMM | Abreviação de mês | Jan, Sep, Dec |
MMMM | Nome completo do mês | January, September, December |
yy | Ano (2 dígitos) | 22, 23 |
yyyy | Ano (4 dígitos) | 2022, 2023 |
H | Hora (0-23) | 0, 14, 23 |
HH | Hora (00-23) | 00, 14, 23 |
h | Hora (1-12) | 1, 6, 12 |
hh | Hora (01-12) | 01, 06, 12 |
m | Minuto (0-59) | 5, 30, 59 |
mm | Minuto (00-59) | 05, 30, 59 |
s | Segundo (0-59) | 5, 30, 59 |
ss | Segundo (00-59) | 05, 30, 59 |
tt | AM/PM | AM, PM |
Formatação de números
Embora não seja mostrado explicitamente nos exemplos básicos, a formatação de números segue padrões semelhantes:
Formato da moeda:
Amount: <<[amount]:"C2">>
Casas decimais:
Value: <<[value]:"F2">>
Percentagem:
Rate: <<[rate]:"P1">>
Combinando formatos com expressões
A formatação pode ser combinada com métodos de enumeração e expressões:
Exemplo:
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">>
Casos de uso práticos
Exemplo de fatura
Modelo:
Invoice #: <<[invoiceNumber]:upper>>
Date: <<[invoiceDate]:"dd.MM.yyyy">>
Company: <<[companyName]:caps>>
Total Amount: $<<[totalAmount]:"F2">>
Exemplo de cabeçalho de relatório
Modelo:
Report Generated: <<[generatedDate]:"MMMM dd, yyyy 'at' HH:mm:ss">>
Generated By: <<[userName]:caps>>
Period: <<[startDate]:"MMM yyyy">> - <<[endDate]:"MMM yyyy">>
Melhores práticas
- Formatos de data consistentes - Utilize o mesmo formato de data em todo o documento.
- Considerações sobre o local - Escolha formatos de data adequados ao seu público.
- Formatação de teste - Verificar os formatos com os dados reais antes da produção.
- Transformações de strings - Aplique a formatação de texto de forma criteriosa para manter a legibilidade.
- Precisão numérica - Utilize o número apropriado de casas decimais para valores monetários e numéricos.
:::Dica: Teste de Formatação Sempre teste sua formatação com dados de exemplo que incluam casos extremos, como valores nulos, strings muito longas ou datas em formatos diferentes, para garantir uma saída consistente.
:::