Найкращі практики шаблонів
Форматування дат
Для виведення дати в шаблоні використовується фільтр formatDate.
Дефолтний формат - 'MMMM dd, yyyy'.
Приклад використання: {{ SomeDate | formatDate }} - March 27, 2024.
Для зміни формату передається параметр у вигляді рядка.
Дата та час в стандартному форматі:
yyyy - Рік (наприклад, 2024).
MM - Місяць (наприклад, 05 для травня).
dd - День (наприклад, 04).
HH - Година у 24-годинному форматі (наприклад, 13 для 1 після обіду).
mm - Хвилина (наприклад, 30).
ss - Секунда (наприклад, 15).
Локалізоване форматування:
LLL - Локалізована дата та час, наприклад: "травень 4, 2024 1:30 PM".
LLLL - Повна локалізована дата та час з інформацією про часовий пояс, наприклад: "субота, 4 травня 2024 13:30 UTC+3".
Додаткові варіанти:
ff - Дробова частина секунди (наприклад, 500 мікросекунд).
SSS - Мілісекунди (наприклад, 500).
ZZ - Часовий пояс в форматі ±HH:mm (наприклад, +03:00 для UTC+3).
A - AM/PM (наприклад, AM або PM).
ZZZ - Ім'я часового поясу (наприклад, "Eastern European Time").
День тижня:
E - День тижня в короткому форматі (наприклад, "Пт" для п'ятниці).
EEEE - Повне ім'я дня тижня (наприклад, "п'ятниця").
Місяць:
MMM - Скорочене ім'я місяця (наприклад, "тра").
MMMM - Повне ім'я місяця (наприклад, "травень").
Приклад використання:
{{ SomeDate | formatDate('yyyy MMMM dd') }} - 2024 March 27
{{ SomeDate | formatDate('M-yyyy') }} - 2-2024
Локалізація дати:
{{ SomeDate | formatDate('yyyy MMMM dd', { locale: "uk" }) }} - 2024 березня 27
{{ SomeDate | formatDate('yyyy LLLL dd', { locale: "uk" }) }} - 2024 березень 27
Вирішення проблеми, якщо дата кінця місяця не правильно форматується:
{{ InvoiceDueDate | formatDate('dd MMMM yyyy', { zone: 'UTC' }) }}
Форматування грошей
Для форматування чисел у грошовий формат з урахуванням символу валюти та точності числа викоритовується фільтр formatMoney
Параментр Currency - валюта інвойсу
Приклад використання:
{{ PayrollBonusTotal | formatMoney(Currency) }} - $223.81
{{ PayrollBonusTotal | formatMoney }} - 223.81
Форматування годин
Для форматування годин та хвилин у зручний для сприйняття формат використовується фільтр formatHours
Приклад використання:
{{ PayrollWorkMinutes | formatHours }} - 210h 00m
Для прибирання нулів в результаті:
{{ PayrollWorkMinutes | formatHours(true) }} - 210hm
Українська локалізація
{{ PayrollWorkMinutes | formatHours(false, 'uk') }} - 210г 00хв
{{ PayrollWorkMinutes | formatHours(true, 'uk') }} - 210гхв
Останній раз змінено