# Định dạng ngày

> Quy ước định dạng ngày và giờ được sử dụng trong Fleetwork API.

Source: https://docs.fleetwork.vn/vi/introduction/date-formats

## 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

```javascript
// 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:

```javascript
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)
```