Parse & konversi timestamp dengan fungsi tanggal dan waktu - Simple Log Service - Alibaba Cloud - Simple Log Service

Fungsi tanggal dan waktu memungkinkan Anda mengonversi, mengekstrak, dan memanipulasi nilai temporal dalam aturan transformasi SLS DSL.

Dalam logika transformasi SLS DSL, semua nilai log disimpan sebagai string. Anda dapat mengonversi tipe data tersebut sesuai kebutuhan skenario Anda.

Waktu dalam log direpresentasikan oleh tiga tipe data utama. Gunakan fungsi tanggal dan waktu berikut untuk mengonversi antar format tersebut.

String

Misalnya, 2022/07/03 02-41-26.
UNIX timestamp

Misalnya, 1559500886.
Datetime object

Misalnya, 2022-07-01 10:10:10+08:00 atau 2022-07-01 10:10:10.

Catatan

UNIX timestamp juga merupakan string.

Di antara fungsi tanggal dan waktu yang dijelaskan di sini, hanya dt_parse, dt_str, dan dt_parsetimestamp yang menerima ketiga tipe data tersebut sebagai parameter. Untuk fungsi lainnya, tipe parameter harus konsisten.

Fungsi

Kategori	Fungsi	Deskripsi
Konversi datetime umum	dt_parse	Mengonversi nilai atau nilai ekspresi waktu menjadi objek datetime.
	dt_str	Mengonversi nilai atau nilai ekspresi waktu menjadi string.
	dt_parsetimestamp	Mengonversi nilai atau nilai ekspresi waktu menjadi UNIX timestamp.
	dt_prop	Mendapatkan properti tertentu dari nilai atau nilai ekspresi waktu, seperti hari dan tahun.
Dapatkan tanggal dan waktu	dt_now	Mendapatkan objek datetime saat ini.
	dt_today	Mendapatkan tanggal saat ini tanpa komponen waktu.
	dt_utcnow	Mendapatkan objek datetime saat ini dalam zona waktu saat ini.
	dt_fromtimestamp	Mengonversi UNIX timestamp menjadi objek datetime.
	dt_utcfromtimestamp	Mengonversi UNIX timestamp menjadi objek datetime dalam zona waktu saat ini.
	dt_strptime	Mengurai string waktu menjadi objek datetime.
Ambil UNIX timestamp	dt_currentstamp	Mendapatkan UNIX timestamp saat ini.
Ambil UNIX timestamp	dt_totimestamp	Mengonversi objek datetime menjadi UNIX timestamp.
Ambil string datetime	dt_strftime	Mengonversi objek datetime menjadi string dalam format tertentu.
Ambil string datetime	dt_strftimestamp	Mengonversi UNIX timestamp menjadi string dalam format tertentu.
Modifikasi datetime	dt_truncate	Memotong nilai atau nilai ekspresi waktu hingga granularitas waktu tertentu.
	dt_add	Memodifikasi nilai atau nilai ekspresi waktu berdasarkan granularitas waktu tertentu.
	dt_MO	Nilai yang diteruskan ke parameter `weekday` fungsi `dt_add` untuk menentukan offset ke hari Senin.
	dt_TU	Nilai yang diteruskan ke parameter `weekday` fungsi `dt_add` untuk menentukan offset ke hari Selasa.
	dt_WE	Nilai yang diteruskan ke parameter `weekday` fungsi `dt_add` untuk menentukan offset ke hari Rabu.
	dt_TH	Nilai yang diteruskan ke parameter `weekday` fungsi `dt_add` untuk menentukan offset ke hari Kamis.
	dt_FR	Nilai yang diteruskan ke parameter `weekday` fungsi `dt_add` untuk menentukan offset ke hari Jumat.
	dt_SA	Nilai yang diteruskan ke parameter `weekday` fungsi `dt_add` untuk menentukan offset ke hari Sabtu.
	dt_SU	Nilai yang diteruskan ke parameter `weekday` fungsi `dt_add` untuk menentukan offset ke hari Minggu.
Modifikasi zona waktu	dt_astimezone	Mengonversi nilai atau nilai ekspresi waktu menjadi objek datetime dalam zona waktu tertentu.
Ambil selisih	dt_diff	Mendapatkan selisih antara dua nilai atau nilai ekspresi waktu pada granularitas tertentu.

dt_parse

Mengonversi nilai atau ekspresi waktu menjadi objek datetime.

Sintaks
```
dt_parse(value, tz=None)
```

Parameter

Nama Parameter	Tipe parameter	Wajib	Deskripsi
value	String, UNIX timestamp, atau objek datetime	Ya	Nilai atau ekspresi waktu.
tz	String	Tidak	Zona waktu. Nilai default adalah None. Untuk informasi lebih lanjut, lihat Zona waktu.

Respons

Mengembalikan objek datetime hasil konversi.

Contoh

Contoh 1: Mengonversi nilai bidang time menjadi objek datetime.

Log mentah
```
time: 1559500886
```
Aturan transformasi
```
e_set("test_time", dt_parse(v("time")))
```

Hasil

time: 1559500886
test_time: 2019-06-02 18:41:26

Contoh 2: Mengonversi nilai bidang time menjadi objek datetime dalam zona waktu Asia/Shanghai.

Log mentah

time: 2019-06-01 10:10:10
tz: Asia/Shanghai

Aturan transformasi

e_set("test_time", dt_parse(v("time"),tz=v("tz")))

Hasil

time: 2019-06-01 10:10:10
tz: Asia/Shanghai
test_time: 2019-06-01 10:10:10+08:00

dt_str

Mengonversi nilai atau ekspresi waktu menjadi string.

Sintaks

dt_str(value, fmt="format_string", tz=None)

Parameter

Nama Parameter	Tipe parameter	Wajib	Deskripsi
value	String, UNIX timestamp, atau objek datetime	Ya	Nilai atau ekspresi waktu.
fmt	String	Tidak	String format. Untuk informasi lebih lanjut, lihat Direktif format tanggal dan waktu. Jika Anda biarkan kosong, format asli akan digunakan. Nilai default adalah kosong.
tz	String	Tidak	Zona waktu. Nilai default adalah None. Untuk informasi lebih lanjut, lihat Zona waktu.

Respons

Mengembalikan string waktu hasil konversi.

Contoh

Contoh 1: Mengonversi nilai bidang time ke format yang ditentukan dalam zona waktu Asia/Tokyo.

Log mentah

time: 2019-06-03 02:41:26
fmt: %Y/%m/%d %H-%M-%S
tz: Asia/Tokyo

Aturan transformasi

e_set("dt_str", dt_str(v("time"),fmt=v("fmt"),tz=v("tz")))

Hasil

time: 2019-06-03 02:41:26
fmt: %Y/%m/%d %H-%M-%S
tz: Asia/Tokyo
dt_str: 2019/06/03 02-41-26

Contoh 2: Mengonversi nilai bidang time, yang merupakan UNIX timestamp, ke format yang ditentukan.

Log mentah
```
time: 1559500886
fmt: %Y/%m/%d %H-%M-%S
```

Aturan transformasi

e_set("dt_str", dt_str(v("time"),fmt=v("fmt")))

Hasil

time: 1559500886
fmt: %Y/%m/%d %H-%M-%S
dt_str: 2019/06/02 18-41-26

Contoh 3: Mengonversi nilai bidang time ke format default.

Log mentah
```
time: 2019-06-03 02:41:26
```
Aturan transformasi
```
e_set("dt_str", dt_str(v("time")))
```

Hasil

time: 2019-06-03 02:41:26
dt_str: 2019-06-03 02:41:26

dt_parsetimestamp

Mengonversi nilai atau ekspresi waktu menjadi UNIX timestamp.

Sintaks
```
dt_parsetimestamp(value, tz=None)
```

Parameter

Parameter	Tipe parameter	Wajib	Deskripsi
value	String, UNIX timestamp, atau objek datetime	Ya	Nilai atau ekspresi waktu.
tz	String	Tidak	Zona waktu. Nilai default adalah None. Untuk informasi lebih lanjut, lihat Zona waktu.

Respons

Mengembalikan UNIX timestamp hasil konversi.

Contoh

Contoh 1: Mengonversi nilai bidang time menjadi timestamp dalam zona waktu Asia/Tokyo.

Log mentah
```
time: 2019-06-03 2:41:26
tz: Asia/Tokyo
```

Aturan transformasi

e_set("dt_parsetimestamp", dt_parsetimestamp(v("time"),v("tz")))

Hasil

time: 2019-06-03 2:41:26
tz: Asia/Tokyo
dt_parsetimestamp: 1559497286

Contoh 2: Mengonversi nilai bidang time menjadi UNIX timestamp.

Log mentah
```
time: 2019-06-03 2:41:26
```

Aturan transformasi

e_set("dt_parsetimestamp",dt_parsetimestamp(v("time")))

Hasil

time: 2019-06-03 2:41:26
dt_parsetimestamp: 1559529686

Contoh 3: Mengonversi nilai bidang time menjadi UNIX timestamp.

Log mentah
```
time: 2019-06-03 02:41:26+8:00
```

Aturan transformasi

e_set("dt_parsetimestamp",dt_parsetimestamp(v("time")))

Hasil

time: 2019-06-03 02:41:26+8:00
dt_parsetimestamp: 1559500886

dt_prop

Mengekstrak properti tertentu dari nilai atau ekspresi waktu, seperti hari atau tahun.

Sintaks
```
dt_prop(value, props)
```

Parameter

Nama Parameter	Tipe parameter	Wajib	Deskripsi
value	String, UNIX timestamp, atau objek datetime	Ya	Nilai atau ekspresi waktu.
props	String	Ya	Properti waktu yang akan diambil. Misalnya, jika Anda mengatur parameter ini ke year, hanya tahun yang dikembalikan. Nilai yang valid meliputi `day`, `year`, `month`, `hour`, `second`, `minute`, `microsecond`, `weekday`, `weekdayname`, `weekdayshortname`, `monthname`, `monthshortname`, `dayofyear`, `dayofweek`, `weekofyear`, `weekofyear_m`, `tzname`, dan `weekofmonth`.

Respons

Mengembalikan properti yang diekstrak.

Contoh

Contoh 1: Mengekstrak properti day dari nilai bidang time.

Log mentah
```
time: 2018-10-2 09:11:40
```

Aturan transformasi

e_set("dt_parsetimestamp",dt_prop(dt_parse(v("time")),"day"))

Hasil

time: 2018-10-2 09:11:40
dt_parsetimestamp: 2

Contoh 2: Mengekstrak properti year dari nilai bidang time.

Log mentah
```
time: 2018-10-2 09:11:40
```

Aturan transformasi

e_set("dt_parsetimestamp",dt_prop(dt_parse(v("time")),"year"))

Hasil

time: 2018-10-2 09:11:40
dt_parsetimestamp: 2018

Contoh 3: Mengekstrak properti weekdayname dari nilai bidang time.

Log mentah

time: 2018-10-2 09:11:40
weekdayname: weekdayname

Aturan transformasi

e_set("dt_prop",dt_prop(dt_parse(v("time")),"weekdayname"))

Hasil

time: 2018-10-2 09:11:40
dt_prop: Tuesday

Contoh 4: Mengekstrak properti weekofyear dari nilai bidang time.

Log mentah
```
time: 2018-10-2 09:11:40
```

Aturan transformasi

e_set("dt_prop",dt_prop(dt_parse(v("time")),"weekofyear"))

Hasil
```
time: 2018-10-2 09:11:40
dt_prop: 39
```

dt_now

Mengembalikan objek datetime saat ini.

Sintaks
```
dt_now(tz=None)
```
Parameter

Nama parameter

Tipe Parameter

Wajib

Deskripsi

tz

String

Tidak

Zona waktu. Nilai default adalah None. Untuk informasi lebih lanjut, lihat Zona waktu.
Respons

Mengembalikan objek datetime untuk zona waktu yang ditentukan.

Contoh

Mengembalikan waktu saat ini dalam zona waktu Asia/Shanghai.

Log mentah
```
tz: Asia/Shanghai
```
Aturan transformasi
```
e_set("dt_now",dt_now(tz=v("tz")))
```

Hasil

tz: Asia/Shanghai
dt_now: 2022-06-30 11:21:25.111836+08:00

dt_today

Mengembalikan tanggal saat ini tanpa komponen waktu.

Sintaks
```
dt_today(tz=None)
```
Parameter

Nama Parameter

Tipe parameter

Wajib

Deskripsi

tz

String

Tidak

Zona waktu. Nilai default adalah None. Untuk informasi lebih lanjut, lihat Zona waktu.
Respons

Mengembalikan objek tanggal untuk zona waktu yang ditentukan.
Contoh

Mengembalikan tanggal saat ini tanpa komponen waktu.
- Log mentah
```
None
```
- Aturan transformasi
```
e_set("dt_today", dt_today())
```
- Hasil
```
dt_today: 2022-06-30 00:00:00
```

dt_utcnow

Mengembalikan objek datetime saat ini dalam zona waktu lokal.

Sintaks
```
dt_utcnow()
```
Parameter

Tidak ada.
Respons

Mengembalikan objek datetime saat ini.
Contoh

Mengembalikan waktu saat ini berdasarkan zona waktu lokal.
- Log mentah
```
None
```
- Aturan transformasi
```
e_set("dt_utcnow",dt_utcnow())
```
- Hasil
```
dt_utcnow:2022-06-30 03:33:56.614005
```

dt_fromtimestamp

Mengonversi UNIX timestamp menjadi objek datetime.

Sintaks
```
dt_fromtimestamp(value, tz=None)
```

Parameter

Nama Parameter	Tipe parameter	Wajib	Deskripsi
value	String	Ya	Nilai atau ekspresi waktu.
tz	String	Tidak	Zona waktu. Nilai default adalah None. Untuk informasi lebih lanjut, lihat Zona waktu.

Respons

Mengembalikan objek datetime hasil konversi.

Contoh

Contoh 1: Mengonversi nilai bidang time menjadi objek datetime.

Log mentah
```
time: 1559500886
```

Aturan transformasi

e_set("dt_fromtimestamp",dt_fromtimestamp(v("time")))

Hasil

time: 1559500886
dt_fromtimestamp: 2019-06-02 18:41:26

Contoh 2: Mengonversi nilai bidang time menjadi objek datetime dalam zona waktu Asia/Shanghai.

Log mentah
```
time: 1559500886
tz: Asia/Shanghai
```

Aturan transformasi

e_set("dt_fromtimestamp",dt_fromtimestamp(v("time"),tz=v("tz")))

Hasil

time: 1559500886
tz: Asia/Shanghai
dt_fromtimestamp: 2019-06-03 02:41:26+08:00

dt_utcfromtimestamp

Mengonversi stempel waktu UNIX menjadi objek datetime di zona waktu saat ini.

Sintaks
```
dt_utcfromtimestamp(value)
```
Parameter

Parameter

Tipe parameter

Wajib

Deskripsi

value

String

Ya

Nilai atau ekspresi waktu.
Respons

Mengembalikan objek datetime hasil konversi.

Contoh

Log mentah
```
time: 1559500886
```

Aturan transformasi

e_set("dt_utcfromtimestamp",dt_utcfromtimestamp(v("time")))

Hasil

time: 1559500886
dt_utcfromtimestamp: 2019-06-02 18:41:26

dt_strptime

Mengurai string waktu menjadi objek datetime.

Sintaks
```
dt_strptime(value, "format_string")
```

Parameter

Nama Parameter	Tipe parameter	Wajib	Deskripsi
value	String	Ya	Nilai atau ekspresi waktu.
fmt	String	Tidak	String format. Untuk informasi lebih lanjut, lihat Direktif format tanggal dan waktu.

Respons

Mengembalikan objek datetime hasil penguraian.

Contoh

Log mentah

time: 2019/06/03 02-41-26
fmt: %Y/%m/%d %H-%M-%S

Aturan transformasi

e_set("dt_strptime",dt_strptime(v("time"),v("fmt")))

Hasil

time: 2019/06/03 02-41-26
fmt: %Y/%m/%d %H-%M-%S
dt_strptime: 2019-06-03 02:41:26

dt_currentstamp

Mengembalikan UNIX timestamp saat ini.

Sintaks

dt_currentstamp(value, normalize='floor')

Parameter

Nama Parameter

Tipe Parameter

Wajib

Deskripsi

value

String

Nilai atau ekspresi waktu.

normalize

String

Tidak

Format numerik hasil. Nilai yang valid:

floor (default): Membulatkan angka ke bawah.
int: Mengembalikan bagian bilangan bulat.
round: Membulatkan angka.
ceil: Membulatkan angka ke atas.

Respons

Mengembalikan UNIX timestamp saat ini.

Contoh

Log mentah
```
None
```

Aturan transformasi

e_set("dt_currentstamp",dt_currentstamp())

Hasil
```
dt_currentstamp: 1656560437
```

dt_totimestamp

Mengonversi objek datetime menjadi UNIX timestamp.

Sintaks
```
dt_totimestamp(timeexpression)
```
Parameter

Nama Parameter

Tipe parameter

Wajib

Deskripsi

timeexpression

Objek datetime

Ya

Objek datetime yang akan dikonversi.
Respons

Mengembalikan UNIX timestamp hasil konversi.

Contoh

Log mentah
```
time: 2019-06-03 2:41:26
```

Aturan transformasi

e_set("dt_totimestamp",dt_totimestamp(dt_parse(v("time"))))

Hasil

time: 2019-06-03 2:41:26
dt_totimestamp: 1559529686

dt_strftime

Mengonversi objek datetime menjadi string dalam format tertentu.

Sintaks

dt_strftime(timeexpression, "format_string")

Parameter

Nama Parameter	Tipe parameter	Wajib	Deskripsi
timeexpression	Objek datetime	Ya	Objek datetime yang akan dikonversi.
format_string	String	Ya	String format. Untuk informasi lebih lanjut, lihat Direktif format tanggal dan waktu.

Respons

Mengembalikan string yang diformat.

Contoh

Mengonversi nilai bidang time ke format yang ditentukan.

Log mentah

time: 2019-06-03 2:41:26
fmt: %Y/%m/%d %H-%M-%S

Aturan transformasi

e_set("dt_strftime",dt_strftime(dt_parse(v("time")),v("fmt")))

Hasil

time: 2019-06-03 2:41:26
fmt: %Y/%m/%d %H-%M-%S
dt_strftime: 2019/06/03 02-41-26

dt_strftimestamp

Mengonversi UNIX timestamp menjadi string dalam format tertentu.

Sintaks

dt_strftimestamp(value, fmt="format_string", tz=None)

Parameter

Nama Parameter	Tipe parameter	Wajib	Deskripsi
value	String	Ya	UNIX timestamp yang akan dikonversi.
fmt	String	Ya	String format. Untuk informasi lebih lanjut, lihat Direktif format tanggal dan waktu.
tz	String	Tidak	Zona waktu. Nilai default adalah None, yang menggunakan UTC. Untuk informasi lebih lanjut, lihat Zona waktu.

Respons

Mengembalikan string yang diformat.

Contoh

Contoh 1

Log mentah
```
time: 1559500886
fmt: %Y/%m/%d %H-%M-%S
```

Aturan transformasi

e_set("dt_strftimestamp",dt_strftimestamp(v("time"),v("fmt")))

Hasil

time: 1559500886
fmt: %Y/%m/%d %H-%M-%S
dt_strftimestamp: 2019/06/02 18-41-26

Contoh 2

Log mentah

time: 1559500886
fmt: %Y/%m/%d %H-%M-%S
tz: Asia/Tokyo

Aturan transformasi

e_set("dt_strftimestamp",dt_strftimestamp(v("time"),v("fmt"),v("tz")))

Hasil

dt_strftimestamp:2019/06/03 03-41-26
fmt:%Y/%m/%d %H-%M-%S
time:1559500886
tz:Asia/Tokyo

dt_truncate

Memotong nilai atau ekspresi waktu hingga granularitas waktu tertentu.

Sintaks
```
dt_truncate(value, unit='day')
```

Parameter

Nama Parameter	Tipe parameter	Wajib	Deskripsi
value	String, UNIX timestamp, atau objek datetime	Ya	Nilai atau ekspresi waktu.
unit	String	Ya	Granularitas waktu untuk pemotongan. Nilai default adalah day. Nilai opsional meliputi `second`, `minute`, `<num>_minute` (misalnya, 5_minute, 19_minute, dan 2_minute), `hour`, `day`, `week`, `month`, `quarter`, `half_year`, dan `year`.

Respons

Mengembalikan nilai yang dipotong pada granularitas waktu yang ditentukan.

Contoh

Contoh 1

Log mentah
```
time: 2019-06-03 2:41:26
unit: year
```

Aturan transformasi

e_set("dt_truncate",dt_truncate(v("time"),v("unit")))

Hasil

time: 2019-06-03 2:41:26
unit: year
dt_truncate: 2019-01-01 00:00:00

Contoh 2

Log mentah
```
time: 2019-06-03 2:41:26
unit: hour
```

Aturan transformasi

e_set("dt_truncate",dt_truncate(v("time"),v("unit")))

Hasil

time: 2019-06-03 2:41:26
unit: hour
dt_truncate: 2019-06-03 02:00:00

dt_add

Memodifikasi nilai atau ekspresi waktu berdasarkan granularitas waktu tertentu.

Sintaks

dt_add(value, dt1=None, dt2=None, year(s)=None, month(s)=None, day(s)=None, hour(s)=None, minute(s)=None, second(s)=None, microsecond(s)=None, week(s)=None, weekday=None)

Parameter

Nama Parameter	Tipe parameter	Wajib	Deskripsi
value	String, UNIX timestamp, atau objek datetime	Ya	Ekspresi datetime.
dt1	String, UNIX timestamp, atau objek datetime	Tidak	Ekspresi datetime. Nilai default adalah None.
dt2	String, UNIX timestamp, atau objek datetime	Tidak	Ekspresi datetime. Nilai default adalah None.
year/years	Angka	Tidak	year: Tahun untuk menggantikan tahun asli. Misalnya, `year=2020`. Nilai default adalah None. years: Jumlah tahun yang ditambahkan. Misalnya, `years=1` menambahkan satu tahun ke tahun asli.
day/days	Angka	Tidak	day: Hari untuk menggantikan hari asli. Misalnya, `day=1`. Nilai default adalah None. days: Jumlah hari yang ditambahkan. Misalnya, `days=1` menambahkan satu hari ke hari asli.
hour/hours	Angka	Tidak	hour: Jam untuk menggantikan jam asli. Misalnya, `hour=1`. Nilai default adalah None. hours: Jumlah jam yang ditambahkan. Misalnya, `hours=1` menambahkan satu jam ke jam asli.
minute/minutes	Angka	Tidak	minute: Menit untuk menggantikan menit asli. Misalnya, `minute=1`. Nilai default adalah None. minutes: Jumlah menit yang ditambahkan. Misalnya, `minutes=1` menambahkan satu menit ke menit asli.
second/seconds	Angka	Tidak	second: Detik untuk menggantikan detik asli. Misalnya, `second=1`. Nilai default adalah None. seconds: Jumlah detik yang ditambahkan. Misalnya, `seconds=1` menambahkan satu detik ke detik asli.
microsecond/microseconds	Angka	Tidak	microsecond: Menentukan jumlah mikrodetik. Misalnya, `microsecond=1`. Nilai default adalah None. microseconds: Jumlah mikrodetik yang ditambahkan. `microseconds=1` menambahkan satu mikrodetik ke mikrodetik asli.
week/weeks	Angka	Tidak	week: Jumlah minggu untuk offset. Misalnya, `week=1`. Nilai default adalah None. weeks: Jumlah minggu yang ditambahkan. `weeks=1` menambahkan satu minggu ke minggu asli.
weekday	Angka	Tidak	Hari dalam minggu untuk offset. Misalnya, `weekday=dt_MO(1)`. Nilai default adalah None.

Respons

Mengembalikan ekspresi waktu yang dimodifikasi.

Contoh

Contoh 1

Log mentah

dt: 2018-10-10 1:2:3
dt1: 2018-11-3 11:12:13
dt2: 2018-10-1 10:10:10

Aturan transformasi

e_set("dt_add",dt_add(dt_parse(v("dt")), dt1=dt_parse(v("dt1")), dt2=dt_parse(v("dt2"))))

Hasil

dt:2018-10-10 1:2:3
dt1:2018-11-3 11:12:13
dt2:2018-10-1 10:10:10
dt_add:2018-11-12 02:04:06

Contoh 2

Log mentah
```
dt: 2018-10-11 02:03:04
year: 2019
```

Aturan transformasi

e_set("dt_add", dt_add(dt_parse(v("dt")), year=ct_int(v("year"))))

Hasil

dt:2018-10-11 02:03:04
dt_add:2019-10-11 02:03:04
year:2019

dt_MO

Nilai untuk parameter weekday fungsi dt_add yang menentukan offset ke hari Senin.

Sintaks
```
dt_MO(Integer_or_negative)
```

Parameter

Parameter	Tipe	Wajib	Deskripsi
Integer_or_negative	Angka	Ya	Nilai offset. Untuk meneruskan angka negatif, gunakan `op_neg(positive)`. Misalnya, gunakan `op_neg(1)` untuk merepresentasikan -1.

Respons

Mengembalikan waktu offset.

Contoh

Log mentah
```
time: 2019-08-13 02:03:04
```

Aturan transformasi

e_set("dt_MO",dt_add(v("time"),weekday=dt_MO(1)))

Hasil

time: 2019-08-13 02:03:04
dt_MO: 2019-08-19 02:03:04

dt_TU

Nilai untuk parameter weekday fungsi dt_add yang menentukan offset ke hari Selasa.

Sintaks
```
dt_TU(Integer_or_negative)
```

Parameter

Nama parameter	Tipe Parameter	Wajib	Deskripsi
Integer_or_negative	Angka	Ya	Nilai offset. Untuk meneruskan angka negatif, gunakan `op_neg(positive)`. Misalnya, gunakan `op_neg(1)` untuk merepresentasikan -1.

Respons

Mengembalikan waktu offset.
Contoh

Untuk contoh, lihat dt_MO.

dt_WE

Nilai untuk parameter weekday fungsi dt_add yang menentukan offset ke hari Rabu.

Sintaks
```
dt_WE(Integer_or_negative)
```

Parameter

Nama Parameter	Tipe	Wajib	Deskripsi
Integer_or_negative	Angka	Ya	Nilai offset. Untuk meneruskan angka negatif, gunakan `op_neg(positive)`. Misalnya, gunakan `op_neg(1)` untuk merepresentasikan -1.

Respons

Mengembalikan waktu offset.
Contoh

Untuk contoh, lihat dt_MO.

dt_TH

Nilai untuk parameter weekday fungsi dt_add yang menentukan offset ke hari Kamis.

Sintaks
```
dt_TH(Integer_or_negative)
```

Parameter

Nama Parameter	Tipe Parameter	Wajib	Deskripsi
Integer_or_negative	Angka	Ya	Nilai offset. Untuk meneruskan angka negatif, gunakan `op_neg(positive)`. Misalnya, gunakan `op_neg(1)` untuk merepresentasikan -1.

Respons

Mengembalikan waktu offset.
Contoh

Untuk contoh, lihat dt_MO.

dt_FR

Nilai untuk parameter weekday fungsi dt_add yang menentukan offset ke hari Jumat.

Sintaks
```
dt_FR(Integer_or_negative)
```

Parameter

Nama Parameter	Tipe parameter	Wajib	Deskripsi
Integer_or_negative	Angka	Ya	Nilai offset. Untuk meneruskan angka negatif, gunakan `op_neg(positive)`. Misalnya, gunakan `op_neg(1)` untuk merepresentasikan -1.

Respons

Mengembalikan waktu offset.
Contoh

Untuk contoh, lihat dt_MO.

dt_SA

Nilai untuk parameter weekday fungsi dt_add yang menentukan offset ke hari Sabtu.

Sintaks
```
dt_SA(Integer_or_negative)
```

Parameter

Nama Parameter	Tipe Parameter	Wajib	Deskripsi
Integer_or_negative	Angka	Ya	Nilai offset. Untuk meneruskan angka negatif, gunakan `op_neg(positive)`. Misalnya, gunakan `op_neg(1)` untuk merepresentasikan -1.

Respons

Mengembalikan waktu offset.
Contoh

Untuk contoh, lihat dt_MO.

dt_SU

Nilai untuk parameter weekday fungsi dt_add yang menentukan offset ke hari Minggu.

Sintaks
```
dt_SU(Integer_or_negative)
```

Parameter

Nama parameter	Tipe Parameter	Wajib	Deskripsi
Integer_or_negative	Angka	Ya	Nilai offset. Untuk meneruskan angka negatif, gunakan `op_neg(positive)`. Misalnya, gunakan `op_neg(1)` untuk merepresentasikan -1.

Respons

Mengembalikan waktu offset.
Contoh

Untuk contoh, lihat dt_MO.

dt_astimezone

Mengonversi nilai atau ekspresi waktu menjadi objek datetime dalam zona waktu tertentu.

Sintaks
```
dt_astimezone(value, tz, reset=False)
```

Parameter

Parameter	Tipe	Wajib	Deskripsi
value	String, UNIX timestamp, atau objek datetime	Ya	Nilai atau ekspresi waktu.
tz	String	Tidak	Zona waktu. Nilai default adalah None. Untuk informasi lebih lanjut, lihat Zona waktu.
reset	Bool	Tidak	Menentukan apakah zona waktu akan diatur ulang. Nilai default adalah False. Jika Anda mengatur ini ke True, fungsi mengembalikan waktu asli tetapi melampirkan informasi zona waktu baru tanpa mengonversi waktunya sendiri.

Respons

Mengembalikan objek datetime dalam zona waktu yang ditentukan.

Contoh

Contoh 1

Log mentah
```
time: 2019-06-03 2:41:26
tz: UTC
```

Aturan transformasi

e_set("dt_astimezone",dt_astimezone(dt_parse(v("time")), v("tz")))

Hasil

time: 2019-06-03 2:41:26
tz: UTC
dt_astimezone: 2019-06-03 02:41:26+00:00

Contoh 2

Log mentah

time: 2019-06-01 10:10:10+10:00
tz: Asia/Tokyo

Aturan transformasi

e_set("dt_astimezone",dt_astimezone(v("time"), v("tz"),reset=True))

Hasil

time: 2019-06-01 10:10:10+10:00
tz: Asia/Tokyo
dt_astimezone: 2019-06-01 10:10:10+09:00

Contoh 3

Log mentah

time: 2019-06-01 10:10:10+08:00
tz: Asia/Tokyo

Aturan transformasi

e_set("dt_astimezone",dt_astimezone(v("time"), v("tz"),reset=False))
e_set("dt_astimezone_true",dt_astimezone(v("time"), v("tz"),reset=True))

Hasil

dt_astimezone:2019-06-01 11:10:10+09:00
dt_astimezone_true:2019-06-01 10:10:10+09:00
time:2019-06-01 10:10:10+08:00
tz:Asia/Tokyo

dt_diff

Menghitung selisih antara dua nilai atau ekspresi waktu pada granularitas tertentu.

Sintaks

dt_diff(value1, value2, unit='second', normalize='floor')

Parameter

Nama parameter	Tipe parameter	Wajib	Deskripsi
value1	String, UNIX timestamp, atau objek datetime	Ya	Nilai atau ekspresi waktu.
value2	String, UNIX timestamp, atau objek datetime	Ya	Nilai atau ekspresi waktu.
unit	String	Tidak	Unit untuk selisih yang dikembalikan. Nilai default adalah `second`. Nilai valid lainnya meliputi `microsecond`, `millisecond`, `minutes`, `hours`, dan `day`.
normalize	String	Tidak	Format numerik hasil. Nilai yang valid: `floor` (default): Membulatkan angka ke bawah. `int`: Mengembalikan bagian bilangan bulat. `round`: Membulatkan angka ke N tempat desimal. `ceil`: Membulatkan angka ke atas.

Respons

Mengembalikan selisih antara kedua nilai pada granularitas yang ditentukan.

Contoh

Contoh 1: Menghitung selisih antara nilai bidang time1 dan time2 dalam detik.

Log mentah

time1: 2018-10-1 10:10:10
time2: 2018-10-1 10:10:10

Aturan transformasi

e_set("diff",dt_diff(v("time1"), v("time2")))

Hasil

time1: 2018-10-1 10:10:10
time2: 2018-10-1 10:10:10
diff: 0

Contoh 2: Menghitung selisih antara nilai bidang time1 dan time2 dalam detik.

Log mentah

time1: 2018-10-1 11:10:10
time2: 2018-10-1 10:10:10

Aturan transformasi

e_set("diff",dt_diff(v("time1"), v("time2")))

Hasil

time1: 2018-10-1 11:10:10
time2: 2018-10-1 10:10:10
diff: 3600

Contoh 3: Menghitung selisih antara nilai bidang time1 dan time2 dalam mikrodetik.

Log mentah

time1: 2018-10-1 11:10:11
time2: 2018-10-1 10:10:10
unit: microsecond

Aturan transformasi

e_set("diff",dt_diff(v("time1"), v("time2"),v("unit")))

Hasil

diff:3601000000
time1:2018-10-1 11:10:11
time2:2018-10-1 10:10:10
unit:microsecond

Contoh 4: Menghitung selisih antara nilai bidang time1 dan time2 dalam menit dan membulatkan hasil ke bawah.

Log mentah

time1: 2018-10-1 11:11:59
time2: 2018-10-1 10:10:00
unit: minute
normalize: floor

Aturan transformasi

e_set("diff", dt_diff(v("time1"), v("time2"), v("unit"), v("normalize")))

Hasil

diff:61
normalize:floor
time1:2018-10-1 11:11:59
time2:2018-10-1 10:10:00
unit:minute

Contoh 5: Menghitung selisih antara nilai bidang time1 dan time2 dalam detik dan membulatkan hasil ke bawah.

Log mentah

time1: 10:00:00
time2: 11:00:00
unit: second
normalize: floor

Aturan transformasi

e_set("diff", dt_diff(v("time1"), v("time2"), v("unit"), v("normalize")))

Hasil

diff:-3600
normalize:floor
time1:10:00:00
time2:11:00:00
unit:second

Fungsi

dt_parse

Sintaks

Parameter

Respons

Contoh

dt_str

Sintaks

Parameter

Respons

Contoh

dt_parsetimestamp

Sintaks

Parameter

Respons

Contoh

dt_prop

Sintaks

Parameter

Respons

Contoh

dt_now

Sintaks

Parameter

Respons

Contoh

dt_today

Sintaks

Parameter

Respons

Contoh

dt_utcnow

Sintaks

Parameter

Respons

Contoh

dt_fromtimestamp

Sintaks

Parameter

Respons

Contoh

dt_utcfromtimestamp

Sintaks

Parameter

Respons

Contoh

dt_strptime

Sintaks

Parameter

Respons

Contoh

dt_currentstamp

Sintaks

Parameter

Respons

Contoh

dt_totimestamp

Sintaks

Parameter

Respons

Contoh

dt_strftime

Sintaks

Parameter

Respons

Contoh

dt_strftimestamp

Sintaks

Parameter

Respons

Contoh

dt_truncate

Sintaks

Parameter

Respons

Contoh

dt_add

Sintaks

Parameter

Respons