Ця документація була автоматично перекладена штучним інтелектом.
Огляд
Типи полів дати та часу
Типи полів дати та часу можна розділити на такі категорії:
- Дата та час (з часовим поясом): Ці значення стандартизуються до UTC (Всесвітній координований час) і за потреби коригуються відповідно до часового поясу.
- Дата та час (без часового поясу): Цей тип зберігає дані дати та часу без інформації про часовий пояс.
- Дата (без часу): Цей формат зберігає виключно інформацію про дату, без компонента часу.
- Час: Зберігає лише інформацію про час, виключаючи дату.
- Мітка часу Unix: Цей тип зберігається як мітка часу Unix і зазвичай представляє кількість секунд, що минули з 1 січня 1970 року.
Ось приклади для кожного типу поля, пов'язаного з датою та часом:
| Тип поля | Приклад значення | Опис |
|---|---|---|
| Дата та час (з часовим поясом) | 2024-08-24T07:30:00.000Z | Конвертується в UTC і може бути скориговано для часових поясів |
| Дата та час (без часового поясу) | 2024-08-24 15:30:00 | Зберігає дату та час без урахування часових поясів |
| Дата (без часу) | 2024-08-24 | Зберігає лише дату, без інформації про час |
| Час | 15:30:00 | Зберігає лише час, виключаючи будь-які деталі дати |
| Мітка часу Unix | 1724437800 | Представляє секунди з 1970-01-01 00:00:00 UTC |
Порівняння джерел даних
Нижче наведено порівняльну таблицю для NocoBase, MySQL та PostgreSQL:
| Тип поля | NocoBase | MySQL | PostgreSQL |
|---|---|---|---|
| Дата та час (з часовим поясом) | Datetime with timezone | TIMESTAMP DATETIME | TIMESTAMP WITH TIME ZONE |
| Дата та час (без часового поясу) | Datetime without timezone | DATETIME | TIMESTAMP WITHOUT TIME ZONE |
| Дата (без часу) | Date | DATE | DATE |
| Час | Time | TIME | TIME WITHOUT TIME ZONE |
| Мітка часу Unix | Unix timestamp | INTEGER BIGINT | INTEGER BIGINT |
| Час (з часовим поясом) | - | - | TIME WITH TIME ZONE |
Примітка:
- Тип TIMESTAMP у MySQL охоплює діапазон між
1970-01-01 00:00:01 UTCта2038-01-19 03:14:07 UTC. Для дат і часу поза цим діапазоном рекомендується використовувати DATETIME або BIGINT для зберігання міток часу Unix.
Робочий процес обробки зберігання дати та часу
З часовим поясом
Це включає Дату та час (з часовим поясом) та Мітку часу Unix.
Примітка:
- Щоб підтримувати ширший діапазон дат, NocoBase використовує тип DATETIME у MySQL для полів
Дата та час (з часовим поясом). Збережене значення дати конвертується на основі змінної середовища TZ сервера, що означає: якщо змінна середовища TZ зміниться, збережене значення дати та часу також зміниться. - Оскільки існує різниця в часових поясах між UTC та локальним часом, пряме відображення вихідного значення UTC може ввести користувача в оману.
Без часового поясу
UTC
UTC (Всесвітній координований час) — це глобальний стандарт часу, який використовується для координації та синхронізації часу в усьому світі. Це високоточний стандарт часу, що підтримується атомними годинниками та синхронізований з обертанням Землі.
Різниця між UTC та локальним часом може спричинити плутанину при відображенні вихідних значень UTC. Наприклад:
| Часовий пояс | Дата та час |
|---|---|
| UTC | 2024-08-24T07:30:00.000Z |
| UTC+8 | 2024-08-24 15:30:00 |
| UTC+5 | 2024-08-24 12:30:00 |
| UTC-5 | 2024-08-24 02:30:00 |
| UTC+0 | 2024-08-24 07:30:00 |
| UTC-6 | 2024-08-23 01:30:00 |
Усі ці різні часи відповідають одному й тому ж моменту, просто виражені в різних часових поясах.