# Pengubah tanggal

> Pengubah tanggal dan waktu di StackQL: menggeser hasil DATE, TIME, DATETIME, JULIANDAY, dan STRFTIME per hari, bulan, atau tahun, ke awal periode, hari tertentu, dan lainnya.

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

## Ringkasan

Dalam fungsi tanggal dan waktu StackQL, nilai tanggal atau waktu dapat diikuti oleh nol atau beberapa pengubah yang mengubah tanggal, waktu, atau keduanya. Setiap pengubah merupakan transformasi yang diterapkan pada nilai waktu di sebelah kirinya. Pengubah diterapkan secara berurutan dari kiri ke kanan. Pengubah yang tersedia adalah sebagai berikut:

| Pengubah             | Deskripsi                                                                       |
|----------------------|---------------------------------------------------------------------------------|
| NNN day(s)           | Menambahkan ±NNN hari ke tanggal dan waktu                                      |
| NNN hour(s)          | Menambahkan ±NNN jam ke tanggal dan waktu                                       |
| NNN minute(s)        | Menambahkan ±NNN menit ke tanggal dan waktu                                     |
| NNN[.NNNN] second(s) | Menambahkan ±NNN detik ke atau dari tanggal dan waktu                           |
| NNN month(s)         | Menambahkan ±NNN bulan ke tanggal dan waktu                                     |
| NNN year(s)          | Menambahkan ±NNN tahun ke tanggal dan waktu                                     |
| start of month       | Mundur ke awal bulan                                                            |
| start of year        | Mundur ke awal tahun                                                            |
| start of day         | Mundur ke awal hari                                                             |
| weekday N            | Memajukan tanggal ke tanggal berikutnya yang nomor hari dalam minggunya adalah N |
| localtime            | Mengembalikan waktu lokal                                                       |
| utc                  | Mengembalikan waktu UTC                                                         |
| unixepoch            | Waktu Unix                                                                      |

## Contoh

### Mengembalikan tanggal dan waktu saat ini menggunakan nilai waktu `now`

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

### Mengonversi UTC ke waktu lokal menggunakan pengubah `localtime`

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

### Mengonversi datetime ke UTC

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

### Menghitung tanggal relatif terhadap tanggal lain

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

### Mendapatkan hari tertentu berikutnya setelah tanggal yang diberikan

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

### Mendapatkan awal bulan untuk tanggal yang diberikan

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

### Mengonversi stempel waktu Unix ke datetime

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

:::tip 

Untuk mengonversi datetime ke stempel waktu epoch Unix, lihat [**STRFTIME**](/language-spec/functions/datetime/strftime).  Untuk menghitung selisih antara dua objek datetime, lihat [**STRFTIME**](/language-spec/functions/datetime/strftime) atau [**JULIANDAY**](/language-spec/functions/datetime/julianday).

:::
