# Bộ điều chỉnh ngày

> Bộ điều chỉnh ngày giờ trong StackQL: dịch kết quả DATE, TIME, DATETIME, JULIANDAY và STRFTIME theo ngày, tháng hoặc năm, về đầu kỳ, tới một thứ trong tuần và hơn thế.

Source: https://stackql.io/vi/language-spec/functions/datetime/date_modifiers

## Tổng quan

Trong các hàm datetime của StackQL, một giá trị ngày hoặc giờ có thể được theo sau bởi không hoặc nhiều bộ điều chỉnh làm thay đổi ngày và/hoặc giờ. Mỗi bộ điều chỉnh là một phép biến đổi được áp dụng cho giá trị thời gian ở bên trái nó. Các bộ điều chỉnh được áp dụng theo thứ tự từ trái sang phải. Các bộ điều chỉnh hiện có như sau:

| Bộ điều chỉnh | Mô tả |
|----------------------|-----------------------------------------------------------------------|
| NNN day(s)           | Cộng ±NNN ngày vào một giá trị ngày giờ |
| NNN hour(s)          | Cộng ±NNN giờ vào một giá trị ngày giờ |
| NNN minute(s)        | Cộng ±NNN phút vào một giá trị ngày giờ |
| NNN[.NNNN] second(s) | Cộng ±NNN giây vào (hoặc trừ khỏi) một giá trị ngày giờ |
| NNN month(s)         | Cộng ±NNN tháng vào một giá trị ngày giờ |
| NNN year(s)          | Cộng ±NNN năm vào một giá trị ngày giờ |
| start of month       | Lùi về đầu tháng |
| start of year        | Lùi về đầu năm |
| start of day         | Lùi về đầu ngày |
| weekday N            | Đẩy một ngày về phía trước tới ngày kế tiếp có số thứ tự ngày trong tuần là N |
| localtime            | Trả về giờ địa phương |
| utc                  | Trả về giờ UTC |
| unixepoch            | Thời gian Unix |

## Ví dụ

### Trả về ngày và giờ hiện tại bằng giá trị thời gian `now`

```sql
SELECT name, date('now') as date, time('now') as time
FROM google.storage.buckets WHERE project = 'stackql';
```

### Chuyển đổi UTC sang giờ địa phương bằng bộ điều chỉnh `localtime`

```sql
SELECT name, timeCreated,
datetime(timeCreated, 'localtime') as local_time_created
FROM google.storage.buckets WHERE project = 'stackql';
```

### Chuyển đổi giờ địa phương sang UTC

Bộ điều chỉnh `utc` coi đầu vào của nó là giờ địa phương trên máy chạy StackQL và chuyển đổi sang UTC.  Một giá trị đã ở UTC, chẳng hạn như `'now'` hoặc một dấu thời gian có hậu tố `Z`, được trả về không đổi.

```sql
SELECT datetime('2026-11-20 17:59:24', 'utc') as utc_time;
```

Trên máy có múi giờ UTC+11, truy vấn này trả về `2026-11-20 06:59:24`.

### Tính một ngày tương đối so với một ngày khác

```sql
SELECT name, timeCreated,
datetime(timeCreated, '+24 hours') as a_day_later
FROM google.storage.buckets WHERE project = 'stackql';
```

### Lấy ngày trong tuần được chỉ định tiếp theo sau một ngày cho trước

```sql
SELECT name, timeCreated,
datetime(timeCreated, 'weekday 0') as following_sunday
FROM google.storage.buckets WHERE project = 'stackql';
```

### Lấy ngày đầu tháng của một ngày cho trước

```sql
SELECT name, timeCreated,
datetime(timeCreated, 'start of month') as start_of_month
FROM google.storage.buckets WHERE project = 'stackql';
```

### Chuyển đổi dấu thời gian Unix sang datetime

```sql
SELECT datetime(1576417943, 'unixepoch') as date_from_ts
FROM google.storage.buckets WHERE project = 'stackql';
```

:::tip 

Để chuyển đổi một datetime sang dấu thời gian Unix epoch, hãy xem [**STRFTIME**](/language-spec/functions/datetime/strftime).  Để tính chênh lệch giữa hai đối tượng datetime, hãy xem [**STRFTIME**](/language-spec/functions/datetime/strftime) hoặc [**JULIANDAY**](/language-spec/functions/datetime/julianday).

:::
