Định dạng ngày

ISO 8601 (Timestamp)

Tất cả các trường timestamp đều dùng định dạng ISO 8601 theo múi giờ UTC:

2026-04-15T08:30:00Z

Các trường ví dụ: createdAt, updatedAt, completedAt, expiresAt

Chỉ ngày

Các ngày đã lên lịch sử dụng định dạng YYYY-MM-DD:

2026-04-15

Các trường ví dụ: scheduledDate, fromDate, toDate

Epoch mili-giây

Timestamp GPS và các query theo khoảng thời gian dùng epoch mili-giây:

1713139200000

Ví dụ: các tham số query startTime và endTime của lộ trình GPS.

Ví dụ chuyển đổi

// ISO 8601 → Date object
const date = new Date('2026-04-15T08:30:00Z');

// Epoch ms → Date object
const date2 = new Date(1713139200000);

// Date → Epoch ms
const epoch = date.getTime();

// Date → ISO string
const iso = date.toISOString();

Múi giờ

Tất cả timestamp API đều theo múi giờ UTC (được chỉ định bằng hậu tố Z). Hãy chuyển sang giờ địa phương trong ứng dụng phía client:

const utcDate = new Date('2026-04-15T08:30:00Z');
const localString = utcDate.toLocaleString('vi-VN', {
  timeZone: 'Asia/Ho_Chi_Minh'
});
// "15/04/2026, 15:30:00" (UTC+7)