Правило: Перетворення формату дати та часу#
Правило перетворює значення вибраного елемента з одного формату дати та часу в інший. Воно стає в пригоді, коли цільовий канал вимагає іншого запису дати, ніж той, що є у фіді, — наприклад, Unix timestamp у відгуках для Google Product Reviews. Змінювати вхідні дані при цьому не потрібно.
Правило знаходиться в секції Number or price settings — у класичній формі й у Canvas.
Додаткові функції#
- Попередньо визначені формати для найпоширеніших записів дати та часу
- Власний формат із символів-замінників (токенів)
- Кілька дат в одному значенні, наприклад діапазон від і до
- Значення, які не відповідають заданому формату, залишаються без змін, і про них з’являється попередження в журналі застосування правил
Формати#
| Формат | Опис |
|---|---|
YYYY-MM-DD |
Рік-Місяць-День (стандарт ISO 8601) |
YYYY-MM-DDTHH:mmZ |
Формат для Google, UTC |
YYYY-MM-DDTHH:mm:ss |
Дата й час із роздільником «T» (наприклад, 2025-06-24T12:46:12) |
YYYY/MM/DD |
Рік/Місяць/День зі скісними рисками |
DD/MM/YYYY |
День/Місяць/Рік (європейський формат) |
MM/DD/YYYY |
Місяць/День/Рік (американський формат) |
YYYYMMDD |
Компактний формат без роздільників |
DD.MM.YYYY |
День.Місяць.Рік |
X |
Unix timestamp (кількість секунд від 1.01.1970) |
| Власний формат | Формат задаєте самі |
Власний формат#
Після вибору власного формату з’являється текстове поле, у яке формат записується за допомогою цих токенів:
| Токен | Значення |
|---|---|
YYYY |
Рік, чотиризначний |
YY |
Рік, двозначний |
MM |
Місяць, двозначне (01–12) |
M |
Місяць без провідного нуля |
DD |
День, двозначне |
D |
День без провідного нуля |
HH |
Година, двозначне |
H |
Година без провідного нуля |
mm |
Хвилина, двозначне |
ss |
Секунда, двозначне |
X |
Unix timestamp (лише самостійно, без інших токенів) |
- Токени розрізняють регістр:
MM— місяць,mm— хвилина. - Між токенами можна використовувати лише символи
-./:, пробіл,TіZ. - Формат з іншим символом, без токена або порожній зберегти не вдасться — поле відображатиме помилку. Також форма відхиляє пробіли на початку чи в кінці формату.
- Одне значення може містити кілька дат, наприклад
DD.MM.YYYY - DD.MM.YYYY. Новий блок починається там, де повторювався б токен. Блоки мають бути розділені принаймні одним символом, і Format to повинен мати ту саму кількість блоків, що й Format from. Роздільники між форматами можуть відрізнятися.
Як відбувається перетворення#
- Перетворення відбувається в UTC. Правило не переводить між часовими поясами.
- Якщо Format from не містить часу, а Format to — містить, додається
00:00:00. В іншому випадку час відкидається. - Пробіли й переноси рядка на початку або в кінці значення перед перетворенням обрізаються.
- Значення має повністю й точно відповідати Format from, включно з роздільниками та пробілами.
- Значення, яке не відповідає формату (інший формат, часовий пояс у вигляді зсуву, неіснуюча дата, як-от
2025-02-30, інша кількість блоків дат), залишається без змін. До товару записується попередження, і правило продовжує опрацьовувати інші товари. - Unix timestamp зчитується лише як ціле додатне число в секундах.
- Порожнє значення елемента залишається порожнім, без попередження.
Конкретні приклади#
Приклад 1: Unix timestamp на формат для Google Product Reviews#
Вхідний фід містить дату відгуку як Unix timestamp 1725172732, але Google Product Reviews вимагає запис 2024-09-01T06:38:52Z.
- Відкрийте сторінку Rules і натисніть New rule.
- У полі Rule type виберіть Перетворення формату дати та часу.
- У полі Queries виберіть All products або власну вибірку товарів.
- У полі Element виберіть елемент із датою відгуку.
- У полі Format from виберіть X (Unix timestamp).
- У полі Format to виберіть Custom format і введіть
YYYY-MM-DDTHH:mm:ssZ. - Дайте правилу назву, наприклад Дата відгуку у формат для Google.
Приклад 2: Дата доставки з DD.MM.YYYY на YYYY-MM-DD#
Постачальник надсилає дату доставки в елементі DELIVERY_DATE у вигляді 15.11.2026, а цільовий канал потребує міжнародного запису 2026-11-15.
- Відкрийте сторінку Rules і натисніть New rule.
- У полі Rule type виберіть Перетворення формату дати та часу.
- У полі Queries виберіть All products.
- У полі Element виберіть
DELIVERY_DATE. - У полі Format from виберіть
DD.MM.YYYY, у полі Format to —YYYY-MM-DD. - Дайте правилу назву, наприклад Дата доставки у формат ISO.
Часті запитання#
Для чого слугує правило Перетворення формату дати та часу?#
Перетворює значення елемента з одного формату дати та часу в інший — наприклад, дату доставки з DD.MM.YYYY на YYYY-MM-DD або Unix timestamp на формат для Google. Вхідні дані змінювати не потрібно.
У чому різниця між цим правилом і правилом Додавання днів до дати?#
Правило Додавання днів до дати записує сьогоднішню дату, зсунуту на задану кількість днів. Перетворення формату дати та часу нічого не додає — воно лише змінює запис значення, яке вже є в елементі.
Що станеться, якщо значення не відповідає вибраному Format from? #
Значення залишиться без змін. До товару записується попередження, і правило продовжує опрацьовувати інші товари. Попередження можна переглянути в журналі застосування правил — там зазначено, яке значення та який елемент не відповідають формату, з посиланням на правило.
Що станеться з порожнім значенням?#
Порожнє значення залишиться порожнім, без попередження.
Чи перетворює правило часові пояси?#
Ні. Перетворення відбувається в UTC. Значення із часовим поясом у вигляді зсуву не відповідають формату й залишаються без змін.
Чи розпізнає правило формат значення автоматично?#
Ні. Format from потрібно вибирати самостійно, і значення має відповідати йому повністю й точно.
Чи підтримує правило мілісекунди, AM/PM або назви місяців і днів?#
Ні. Правило працює з токенами, зазначеними в таблиці власного формату.
Чи можна перетворити кілька дат в одному значенні?#
Так. Наприклад, значення 01.11.2026 - 15.11.2026 можна перетворити з формату DD.MM.YYYY - DD.MM.YYYY до YYYY-MM-DD - YYYY-MM-DD. Обидва формати мають мати однакову кількість блоків.