> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Fungsi tanggal dan waktu

> Pelajari semua fungsi tanggal dan waktu di platform YiDA — mulai dari menghitung rentang tanggal, mengonversi Stempel waktu menjadi object tanggal, hingga konsep dasar Komponen tanggal untuk desainer formulir.

Artikel ini mencantumkan semua fungsi tanggal dan waktu di YiDA serta masalah yang mungkin Anda temui saat menggunakannya.

## Ikhtisar fungsi

| **Fungsi**                                              | **Deskripsi**                                                                                                                                                                                                            |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [CASCADEDATEINTERVAL](/id/yida/form/py2n7nkaimvsypoe)   | Menghitung jumlah hari antara tanggal mulai dan tanggal akhir pada Komponen pemilih rentang tanggal.                                                                                                                     |
| [CASCADEDATEINTERVALV2](/id/yida/form/blbqwhbcsa44h4tb) | Mengembalikan jumlah hari antara dua tanggal dalam rentang tanggal.                                                                                                                                                      |
| [DATE](/id/yida/form/pxp74275bikx0xvt)                  | Mengonversi Stempel waktu menjadi object tanggal.                                                                                                                                                                        |
| [DATEDELTA](/id/yida/form/tz0uzryeft12rpgw)             | Menambahkan atau mengurangi sejumlah hari tertentu pada tanggal yang ditentukan.                                                                                                                                         |
| [DAY](/id/yida/form/zblyusnwcvrbregn)                   | Mengembalikan tanggal (hari dalam bulan) dari sebuah tanggal.                                                                                                                                                            |
| [DAYBEGIN](/id/yida/form/kuda7hpn6ru4mv2g)              | Mengembalikan Stempel waktu dari Komponen tanggal tertentu dengan jam, menit, dan detik disetel ke nol.                                                                                                                  |
| [DAYEND](/id/yida/form/me7p9i2f32erci85)                | Mengembalikan Stempel waktu dari Komponen tanggal tertentu dengan jam, menit, dan detik disetel ke nilai maksimum.                                                                                                       |
| [DAYS](/id/yida/form/acp1c60wvm7v5g5m)                  | Mengembalikan jumlah hari antara dua tanggal.                                                                                                                                                                            |
| [DAYS360](/id/yida/form/wa3hg2rs7i40eb90)               | Fungsi DAYS360 mengembalikan jumlah hari antara dua tanggal.                                                                                                                                                             |
| [HOUR](/id/yida/form/ly60vx00lfm5mp2r)                  | Mengembalikan jam dari sebuah tanggal.                                                                                                                                                                                   |
| [ISOWEEKNUM](/id/yida/form/bn3zv56eunro0tzd)            | Mengembalikan nomor minggu dari tanggal tertentu dalam satu tahun.                                                                                                                                                       |
| [MINUTE](/id/yida/form/vgvc4f7myfwpbqa5)                | Mengembalikan menit dari sebuah tanggal.                                                                                                                                                                                 |
| [MONTH](/id/yida/form/obwipf12ew36n32a)                 | Mengembalikan bulan dari sebuah tanggal.                                                                                                                                                                                 |
| [NETWORKDAYS](/id/yida/form/qfwh5ivncnfg57wt)           | Menghitung jumlah Hari kerja antara dua tanggal tertentu.                                                                                                                                                                |
| [NOW](/id/yida/form/qn4qo0ydlb2i1iz1)                   | Mengembalikan waktu saat ini. Sama dengan fungsi TODAY.                                                                                                                                                                  |
| [SECOND](/id/yida/form/qpvcqng3gb14aww7)                | Mengembalikan detik dari sebuah tanggal.                                                                                                                                                                                 |
| [SYSTIME](/id/yida/form/enkgisafnaalmkl0)               | Mengembalikan waktu server saat ini.                                                                                                                                                                                     |
| [TIME](/id/yida/form/zl268y77wk9nhwkg)                  | Mengembalikan angka desimal dari waktu tertentu.                                                                                                                                                                         |
| [TIMESTAMP](/id/yida/form/bmgm5sirz825ncal)             | Mengonversi object tanggal menjadi Stempel waktu. Fungsi ini terutama digunakan untuk mengonversi object tanggal yang dihasilkan oleh Formula tanggal menjadi Stempel waktu dan menetapkan nilainya ke Komponen tanggal. |
| [TODAY](/id/yida/form/vzgyog2mozwazdrk)                 | Mengembalikan tanggal hari ini.                                                                                                                                                                                          |
| [WEEKNUM](/id/yida/form/kn045dietny22f9k)               | Mengembalikan nomor minggu dari tanggal tertentu.                                                                                                                                                                        |
| [WORKDAY](/id/yida/form/cwczglfr7liddmmw)               | Menghitung tanggal yang jatuh N Hari kerja setelah tanggal tertentu. Akhir pekan dikecualikan dari Hari kerja secara Default, dan Anda dapat menggunakan hari libur untuk mendefinisikan Hari kerja secara lebih tepat.  |
| [YEAR](/id/yida/form/ghx7avaatnrt3gow)                  | Mengembalikan tahun dari sebuah tanggal.                                                                                                                                                                                 |
| [YEARBEGIN](/id/yida/form/whagovdhgkyy0n4k)             | Mengembalikan tanggal pertama dari tahun tempat sebuah tanggal berada.                                                                                                                                                   |
| [YEAREND](/id/yida/form/vyck0fpn0a1kp2ty)               | Mengembalikan tanggal terakhir dari tahun tempat sebuah tanggal berada.                                                                                                                                                  |

## Konsep dasar

**Komponen tanggal** mengembalikan **Stempel waktu** dalam milidetik.

Dua konsep dasar berikut berkaitan dengan fungsi tanggal:

* Stempel waktu: Stempel waktu adalah format yang digunakan komputer untuk mencatat waktu. Umumnya berupa rangkaian karakter yang secara unik mengidentifikasi suatu momen waktu. Pada Formulir YiDA, Komponen tanggal menyimpan waktu sebagai rangkaian tersebut.
* Object tanggal: Sebuah object tanggal merepresentasikan tahun, bulan, hari, jam, menit, dan detik. Formatnya adalah Sat Aug 01 2015 00:00:00 GMT+0800 (China Standard Time), yaitu 00:00:00 pada 1 Agustus 2015 waktu Beijing. Object tanggal mendukung berbagai operasi, seperti penambahan dan pengurangan tanggal.

Di YiDA, huruf umumnya digunakan untuk merepresentasikan Format tanggal. Tabel berikut mencantumkan arti setiap huruf.

| **Huruf** | **Arti**                     |
| --------- | ---------------------------- |
| G         | Penanda era                  |
| y         | Tahun                        |
| M         | Bulan                        |
| d         | Hari                         |
| h         | Jam dalam AM/PM (1–12)       |
| H         | Jam dalam sehari (0–23)      |
| m         | Menit                        |
| s         | Detik                        |
| S         | Milidetik                    |
| E         | Hari dalam minggu            |
| D         | Hari dalam tahun             |
| F         | Hari dalam minggu pada bulan |
| w         | Minggu dalam tahun           |
| W         | Minggu dalam bulan           |
| a         | Penanda AM/PM                |
| k         | Jam dalam sehari (1–24)      |
| K         | Jam dalam AM/PM (0–11)       |
| z         | Zona Waktu                   |

Contohnya, gunakan pola string `yyyy-MM-dd HH:mm:ss:S E D F w W z` untuk memformat waktu saat ini sebagai Default dari Komponen Teks **Tanggal Terformat**. Definisikan Formula sebagai berikut:

Halaman ditampilkan sebagai berikut:

## FAQ

* Q1: Bagaimana cara menggunakan Formula untuk mendapatkan tanggal saat ini?

A: Buka halaman desainer formulir. Halaman tersebut sudah berisi Komponen tanggal. Pilih Komponen tersebut, pilih **Edit Formula** dari daftar drop-down Default di sebelah kanan, lalu klik tombol biru **Edit Formula** di bawahnya.

Susun Formula lengkap: `TIMESTAMP(NOW())`. Klik **Konfirmasi**, lalu klik **Simpan** di sudut kanan atas halaman desainer halaman.

**Q2: Bagaimana cara mendapatkan tanggal akhir kontrak secara otomatis?**

A: Ikuti langkah-langkah berikut untuk mengonfigurasi tanggal akhir kontrak.

1. Tambah dua Komponen tanggal ke Formulir dan beri nama Tanggal Mulai dan Tanggal Akhir.
2. Tambah dua Komponen Numerik dan beri nama Jangka Waktu Kontrak dan Penyesuaian Tahun Kabisat.

<Steps>
  <Step title="Langkah 1">
    Karena tahun kabisat dan tahun biasa berbeda, durasi kontrak biasanya dihitung berdasarkan tahun biasa (365 hari). Tangani hal ini dengan Formula terlebih dahulu. Agar Formulir tetap ringkas, sembunyikan Bidang ini dan setel datanya ke Selalu kirim. Konfigurasi Formula terperinci ditampilkan di bawah:
  </Step>

  <Step title="Setelah Anda memasukkan waktu mulai kontrak dan jangka waktu kontrak, waktu akhir kontrak akan dihitung secara otomatis. Konfigurasikan Formula sebagai berikut" />
</Steps>

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
DATEDELTA(DATE(DATEDELTA(DATE(Tanggal Mulai),365*Jangka Waktu Kontrak)),-1+Penyesuaian Tahun Kabisat)
```

4. Hasil
