Bagikan melalui

DATEADD

  • Artikel

Berlaku untuk: kolom terhitungTabel terhitungUkurPerhitungan visual

Nota

Fungsi ini tidak disarankan untuk digunakan dalam perhitungan visual karena kemungkinan mengembalikan hasil yang tidak berarti.

Mengembalikan tabel yang berisi kolom tanggal, digeser ke depan atau mundur dalam waktu dengan jumlah interval yang ditentukan dari tanggal dalam konteks saat ini.

Sintaksis

DATEADD(<dates>,<number_of_intervals>,<interval>)

Parameter

Istilah Definisi
dates Kolom yang berisi tanggal.
number_of_intervals Bilangan bulat yang menentukan jumlah interval untuk ditambahkan atau dikurangi dari tanggal.
interval Interval untuk menggeser tanggal. Nilai untuk interval dapat berupa salah satu hal berikut: year, quarter, month, day

Mengembalikan nilai

Tabel yang berisi satu kolom nilai tanggal.

Komentar

Argumen dates dapat berupa salah satu hal berikut:

  • Referensi ke kolom tanggal/waktu,

  • Ekspresi tabel yang mengembalikan satu kolom nilai tanggal/waktu,

  • Ekspresi Boolean yang menentukan tabel kolom tunggal dari nilai tanggal/waktu.

    Nota

    Batasan pada ekspresi Boolean dijelaskan dalam topik, CALCULATE fungsi.

  • Jika angka yang ditentukan untuk number_of_intervals positif, tanggal dalam dates dipindahkan tepat waktu; jika angka negatif, tanggal dalam dates digeser kembali ke waktu.

  • Parameter interval adalah enumerasi, bukan sekumpulan string; oleh karena itu, nilai tidak boleh diapit dalam tanda kutip. Selain itu, nilai: year, quarter, month, day harus dieja secara penuh saat menggunakannya.

  • Tabel hasil hanya menyertakan tanggal yang ada di kolom dates.

  • Jika tanggal dalam konteks saat ini tidak membentuk interval yang berdampingan, fungsi mengembalikan kesalahan.

  • Fungsi ini tidak didukung untuk digunakan dalam mode DirectQuery saat digunakan dalam kolom terhitung atau aturan keamanan tingkat baris (RLS).

Contoh - Menggeser sekumpulan tanggal

Rumus berikut menghitung tanggal yang satu tahun sebelum tanggal dalam konteks saat ini.

= DATEADD(DateTime[DateKey],-1,year)

Konten terkait

Fungsi kecerdasan waktufungsi Tanggal dan waktu