Formato en plantillas de Word - Guía de estilo
Durante la generación de documentos, es posible que deba aplicar un formato específico al contenido que se genera dinámicamente, como formatear fechas, transformar mayúsculas y minúsculas o aplicar formatos numéricos. PDF4me Proporciona potentes funciones de formato para controlar cómo aparecen los datos en los documentos generados.
Sintaxis básica de formato
La sintaxis fundamental para aplicar formato a campos de combinación:
<<[token]:"format">>La especificación del formato se coloca después del nombre del campo, separada por dos puntos y entre comillas.
Formato de cadenas
Transforme y dé formato al contenido de texto utilizando las siguientes opciones de formato de cadena:
Transformación de mayúsculas y minúsculas de texto
Mayúsculas - Convierte toda la cadena a mayúsculas
Sintaxis: <<[token]:upper>>
Ejemplo: <<[name]:upper>> → "JOHN SMITH"
Escriba las palabras con mayúscula inicial. - Pon en mayúscula la primera letra de cada palabra.
Sintaxis: <<[token]:caps>>
Ejemplo: <<[companyName]:caps>> → "Soluciones Pdf4me"
Escriba la primera letra en mayúscula. - Solo pone en mayúscula la primera letra de la cadena.
Sintaxis: <<[token]:firstCap>>
Ejemplo: <<[sentence]:firstCap>> → "Esta es una oración."
Ejemplos de formato de cadenas
Plantilla:
Customer Name: <<[customerName]:upper>>
Product Title: <<[productName]:caps>>
Description: <<[description]:firstCap>>
Datos:
{
"customerName": "john smith",
"productName": "premium software package",
"description": "this is a premium product."
}
Producción:
Customer Name: JOHN SMITH
Product Title: Premium Software Package
Description: This is a premium product.
Formato de fecha y hora
Formatee los valores de fecha y hora utilizando patrones personalizados para mostrar las fechas en el formato que prefiera.
Patrones comunes de formato de fecha
Fecha completa con hora
Sintaxis: <<[token]:"dd MMM yy H:mm:ss">>
Ejemplo: <<[date]:"dd MMM yy H:mm:ss">> → "15 dic. 12 10:10:21"
Formato de fecha estándar
Sintaxis: <<[token]:"dd-MM-yyyy">>
Ejemplo: <<[invoiceDate]:"dd-MM-yyyy">> → "15-12-2022"
Formato de fecha europeo
Sintaxis: <<[token]:"dd.MM.yyyy">>
Ejemplo: <<[invoiceDate]:"dd.MM.yyyy">> → "15.12.2022"
Formato de fecha de EE. UU.
Sintaxis: <<[token]:"MM/dd/yyyy">>
Ejemplo: <<[date]:"MM/dd/yyyy">> → "15/12/2022"
Formato de fecha ISO
Sintaxis: <<[token]:"yyyy-MM-dd">>
Ejemplo: <<[date]:"yyyy-MM-dd">> → "2022-12-15"
Formato de fecha larga
Sintaxis: <<[token]:"MMMM dd, yyyy">>
Ejemplo: <<[date]:"MMMM dd, yyyy">> → "15 de diciembre de 2022"
Cita breve con hora
Sintaxis: <<[token]:"dd/MM/yyyy HH:mm">>
Ejemplo: <<[timestamp]:"dd/MM/yyyy HH:mm">> → "15/12/2022 14:30"
Ejemplo de formato de fecha
Plantilla:
Invoice Date: <<[invoiceDate]:"dd.MM.yyyy">>
Due Date: <<[dueDate]:"MMMM dd, yyyy">>
Timestamp: <<[createdAt]:"dd MMM yy H:mm:ss">>
Datos:
{
"invoiceDate": "2022/09/12",
"dueDate": "2022/10/12",
"createdAt": "2022/09/12 10:30:45"
}
Producción:
Invoice Date: 12.09.2022
Due Date: October 12, 2022
Timestamp: 12 Sep 22 10:30:45
Componentes del formato de fecha
Comprender los componentes del formato de fecha le ayudará a crear formatos de fecha personalizados:
| Componente | Descripción | Ejemplo |
|---|---|---|
d | Día (1-31) | 5, 15, 28 |
dd | Día (01-31) | 05, 15, 28 |
M | Mes (1-12) | 3, 9, 12 |
MM | Mes (01-12) | 03, 09, 12 |
MMM | Abreviatura del mes | Jan, Sep, Dec |
MMMM | Nombre completo del mes | January, September, December |
yy | Año (2 dígitos) | 22, 23 |
yyyy | Año (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 |
Formato de números
Aunque no se muestra explícitamente en los ejemplos básicos, el formato de los números sigue patrones similares:
Formato de moneda:
Amount: <<[amount]:"C2">>
Cifras decimales:
Value: <<[value]:"F2">>
Porcentaje:
Rate: <<[rate]:"P1">>
Combinando formatos con expresiones
El formato se puede combinar con métodos de enumeración y expresiones:
Ejemplo:
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ácticos
Ejemplo de factura
Plantilla:
Invoice #: <<[invoiceNumber]:upper>>
Date: <<[invoiceDate]:"dd.MM.yyyy">>
Company: <<[companyName]:caps>>
Total Amount: $<<[totalAmount]:"F2">>
Ejemplo de encabezado de informe
Plantilla:
Report Generated: <<[generatedDate]:"MMMM dd, yyyy 'at' HH:mm:ss">>
Generated By: <<[userName]:caps>>
Period: <<[startDate]:"MMM yyyy">> - <<[endDate]:"MMM yyyy">>
Mejores prácticas
- Formatos de fecha consistentes - Utilice el mismo formato de fecha en todo el documento.
- Consideraciones locales - Elija formatos de fecha adecuados para su público.
- Formato de prueba - Verificar los formatos con los datos reales antes de la producción.
- transformaciones de cadenas - Aplique el formato de cadena cuidadosamente para mantener la legibilidad.
- Precisión numérica - Utilice la cantidad adecuada de decimales para valores monetarios y numéricos.
:::Consejo: Pruebas de formato Siempre prueba el formato con datos de ejemplo que incluyan casos excepcionales, como valores nulos, cadenas muy largas o fechas en diferentes formatos, para garantizar una salida consistente.
:::