Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Di dalamnya Microsoft Dataverse, Anda dapat menentukan bagaimana nilai tanggal dan waktu ditampilkan kepada pengguna dan bagaimana nilai tersebut disesuaikan untuk zona waktu.
Selain properti standar yang tersedia dengan sebagian besar kolom, kolom tanggal dan waktu memiliki dua properti tambahan:
- Penyesuaian zona waktu: Apakah akan menyesuaikan nilai untuk zona waktu.
- Format: Apakah akan menampilkan bagian waktu dari nilai.
Penyesuaian zona waktu
Dataverse menyimpan semua nilai tanggal dan waktu di zona waktu UTC. Saat aplikasi Anda menampilkan nilai atau nilai pemrosesan yang dimasukkan oleh pengguna, Dataverse dan aplikasi yang diarahkan model dapat menyesuaikan zona waktu pengguna dengan opsi Perilaku ini.
- Lokal pengguna: Sesuaikan nilai untuk zona waktu pengguna. Ini adalah perilaku default untuk format Tanggal dan waktu. Anda dapat mengubahnya sekali menjadi perilaku lain.
- Zona waktu independen: Tidak ada konversi zona waktu. Ini adalah perilaku default untuk format Hanya Tanggal.
Atur zona waktu pengguna dalam opsi pribadi, bukan zona waktu sistem di Windows, Android, iOS, atau macOS. Namun, zona waktu sistem dapat memengaruhi skrip klien yang berfungsi dengan Tanggal JavaScript.
Format
Semua kolom tanggal dan waktu memiliki bagian waktu kecuali jika perilakunya adalah Date Only. Format: menentukan apakah akan menampilkan bagian waktu dari nilai.
- Tanggal dan waktu: Menampilkan tanggal dan waktu nilai.
- Hanya tanggal: Menampilkan bagian tanggal dari nilai saja.
Note
Pengguna masih dapat mengubah bagian waktu jika Format adalah Hanya Tanggal. Misalnya, dengan menggunakan panggilan API Web atau dengan menggunakan kontrol yang memiliki bagian waktu. Perilaku ini berbeda dari PerilakuHanya Tanggal, di mana bagian waktu tidak disimpan sama sekali.
Panduan penggunaan
Gunakan Zona waktu independen ketika informasi zona waktu tidak diperlukan, seperti waktu check-in hotel. Dengan pilihan ini, pengguna di semua zona waktu melihat nilai tanggal dan waktu yang sama persis.
Gunakan Tanggal hanya saat informasi tentang waktu hari dan zona waktu tidak diperlukan, seperti ulang tahun atau hari jadi. Dengan pilihan ini, pengguna di semua zona waktu melihat nilai tanggal yang sama persis.
Zona waktu independen dengan Tanggal saja praktis sama dengan mengatur kolom sebagai Tanggal saja. Gunakan yang pertama jika Anda tidak yakin apakah Anda membutuhkan bagian waktu di masa mendatang.
Important
Hindari format Hanya Tanggal dengan perilaku lokal Pengguna. Pengguna di zona waktu yang berbeda mungkin melihat tanggal yang berbeda, yang tidak dimaksudkan dalam sebagian besar skenario. Saat pengguna menetapkan tanggal di aplikasi berbasis model, bagian waktu secara otomatis diatur ke tengah malam zona waktu mereka. Hal ini dapat menyebabkan tanggal muncul sehari lebih awal atau lebih lambat untuk pengguna lain.
Contoh
Tampilkan nilai
Dataverse menyimpan 2023-10-15T07:30:00Z (atau 2023-10-15 untuk perilaku Hanya Tanggal). Pengguna di zona waktu UTC-8 melihat ini di aplikasi yang diarahkan model atau dengan permintaan Web API untuk nilai yang diformat:
| Perilaku | Format | Tampilkan nilai |
|---|---|---|
| Lokal pengguna | Tanggal dan waktu | 14 Oktober 2023, 11:30 siang |
| Lokal pengguna | Hanya tanggal | 14 Oktober 2023 |
| Independen Zona waktu | Tanggal dan waktu | 15 Oktober 2023, 7.30 pagi |
| Independen Zona waktu | Hanya tanggal | 15 Oktober 2023 |
| Hanya tanggal | - | 15 Oktober 2023 |
Masukkan nilai dalam aplikasi
Pengguna di zona waktu UTC-8 memasukkan October 14th, 2023, 11:30 pm ke aplikasi yang diarahkan model. Nilai disimpan di Dataverse sebagai:
| Perilaku | Format | Nilai yang disimpan di Dataverse |
|---|---|---|
| Lokal pengguna | Tanggal dan waktu | 2023-10-15T07:30:00Z |
| Lokal pengguna | Hanya tanggal | 2023-10-15T07:30:00Z |
| Independen Zona waktu | Tanggal dan waktu | 2023-10-14T23:30:00Z |
| Independen Zona waktu | Hanya tanggal | 2023-10-14T23:30:00Z |
| Hanya tanggal | - | 2023-10-14 |
Jika pengguna hanya memasukkan tanggal October 14th, 2023, bagian waktu diasumsikan adalah pukul 12.00 tengah malam.
| Perilaku | Format | Nilai yang disimpan di Dataverse |
|---|---|---|
| Lokal pengguna | Hanya tanggal | 2023-10-14T08:00:00Z |
| Independen Zona waktu | Hanya tanggal | 2023-10-14T00:00:00Z |
| Hanya tanggal | - | 2023-10-14 |
Masukkan nilai yang tidak valid dalam aplikasi
Klien yang berbeda memiliki cara yang berbeda untuk menangani input yang tidak valid. Misalnya, di zona waktu Pasifik, penghematan siang hari dimulai pada 12 Maret 2023 pukul 02.00, memindahkan waktu maju satu jam ke pukul 03.00. Waktu antara pukul 02.00 dan 03.00 pada hari itu tidak ada. Saat pengguna mencoba memasukkan nilai dalam rentang waktu tersebut, aplikasi dapat melakukan salah satu hal berikut:
- Ubah ke waktu valid sebelumnya atau berikutnya.
- Kembali ke nilai terakhir yang diketahui.
- Tampilkan Pesan Kesalahan.
- Jangan tampilkan waktu antara pukul 02.00 dan 03.00 di pemilih waktu, sehingga pengguna tidak dapat memilihnya sejak awal.
Demikian pula, klien yang berbeda memiliki cara yang berbeda untuk menangani rentang waktu berulang. Misalnya, di zona waktu Pasifik, penghematan siang hari berakhir pada 5 November 2023 pukul 02.00, memindahkan waktu mundur satu jam ke pukul 01.00. Waktu antara pukul 01:00 dan 02:00 pada hari itu diulang dua kali. Waktu seperti 1.30 pagi dapat merujuk ke salah satu zona waktu. Jika Anda perlu menampilkan atau memasukkan waktu dengan jelas dalam rentang tersebut, sebaiknya beralih sementara ke zona waktu yang tidak menggunakan waktu musim panas.
Mendapatkan nilai mentah dengan Web API
Dataverse menyimpan 2023-10-15T07:30:00Z (atau 2023-10-15 untuk perilaku Hanya Tanggal). Pengguna di semua zona waktu mendapatkan nilai-nilai ini dengan permintaan API Web untuk nilai :
| Perilaku | Format | Nilai mentah |
|---|---|---|
| Lokal pengguna | Tanggal dan waktu | 2023-10-15T07:30:00Z |
| Lokal pengguna | Hanya tanggal | 2023-10-15T07:30:00Z |
| Independen Zona waktu | Tanggal dan waktu | 2023-10-15T07:30:00Z |
| Independen Zona waktu | Hanya tanggal | 2023-10-15T07:30:00Z |
| Hanya tanggal | - | 2023-10-15 |
Mendapatkan nilai dengan API klien
Pengguna di zona waktu UTC-8 memasukkan October 14th, 2023, 11:30 pm ke aplikasi yang diarahkan model. Fungsi API Klien seperti formContext.getAttribute(<column name>).getValue() mengembalikan nilai dengan penyesuaian zona waktu yang diterapkan:
| Perilaku | Format | Javascript dateValue.toUTCString() |
|---|---|---|
| Lokal pengguna | Tanggal dan waktu | 2023-10-15 07:30 (UTC) |
| Lokal pengguna | Hanya tanggal | 2023-10-15 07:30 (UTC) |
Untuk perilaku independen zona waktu, nilai Tanggal JavaScript berada di zona waktu browser:
| Perilaku | Format | Javascript dateValue.toString() |
|---|---|---|
| Independen Zona waktu | Tanggal dan waktu | 2023-10-14 23:30 (zona waktu browser) |
| Independen Zona waktu | Hanya tanggal | 2023-10-14 23:30 (zona waktu browser) |
Nilai tanggal JavaScript selalu memiliki komponen waktu. Itu sebabnya perilaku Hanya Tanggal memiliki komponen waktu pukul 12.00 malam:
| Perilaku | Format | Javascript dateValue.toString() |
|---|---|---|
| Hanya tanggal | - | 2023-10-15 00:00 (zona waktu browser) |
Note
Nilai tanggal JavaScript dipengaruhi oleh zona waktu browser, yang berasal dari pengaturan sistem operasi perangkat.
Untuk Perilaku lokal pengguna , interpretasikan hasil API Klien sebagai nilai UTC. Gunakan Date.getUTCDate() atau Date.getUTCHours() untuk bekerja dengannya. Untuk mendapatkan apa yang dilihat pengguna, terapkan getTimeZoneOffsetMinutes. Jangan gunakan Date.getDate() atau Date.getHours() karena fungsi-fungsi ini menunjukkan nilai di zona waktu browser.
Untuk perilaku zona waktu independen dan hanya tanggal, interpretasikan hasil API Klien sebagai nilai dalam zona waktu browser. Gunakan Date.getDate() atau Date.getHours() untuk bekerja dengannya. Jangan gunakan Date.getUTCDate() atau Date.getUTCHours() karena Anda tidak perlu menyesuaikan zona waktu apa pun.
Mengubah perilaku lokal pengguna
Kecuali penerbit solusi terkelola mencegah perubahan perilaku lokal, Anda dapat mengubah perilaku kolom tanggal kustom yang ada dari Pengguna lokal ke hanya Tanggal atau Zona waktu independen. Ini adalah perubahan satu kali.
Mengubah perilaku kolom memengaruhi nilai kolom yang ditambahkan atau diubah setelah perilaku kolom diubah. Nilai kolom yang ada tetap ada dalam basis dara dengan format zona waktu UTC. Untuk mengubah perilaku nilai kolom yang ada dari UTC ke Hanya Tanggal, Anda mungkin memerlukan bantuan pengembang untuk mengonversi perilaku nilai tanggal dan waktu yang ada dalam database.
Peringatan
Sebelum mengubah perilaku kolom tanggal dan waktu yang ada, tinjau semua dependensi kolom, seperti aturan bisnis, alur kerja, kolom terhitung, atau kolom rollup, untuk memastikan bahwa tidak ada masalah sebagai akibat dari mengubah perilaku. Setelah mengubah perilaku kolom tanggal dan waktu, buka setiap aturan bisnis, alur kerja, kolom hitung, dan kolom rollup tergantung pada kolom yang Anda ubah, mengulas informasi, dan menyimpannya, untuk memastikan perilaku dan nilai kolom tanggal dan waktu terbaru digunakan.
Mengubah perilaku selama impor solusi
Saat Anda mengimpor solusi yang berisi kolom Tanggal dengan Pengguna lokal, Anda dapat mengubah perilaku menjadi Zona tanggal saja atau Zona waktu independen.
Note
Anda hanya dapat mengubah perilaku kolom Hanya Tanggal atau Tanggal dan waktu terkelola yang ada jika Anda adalah penerbit. Untuk membuat perubahan pada bidang ini, peningkatan harus dilakukan ke solusi yang menambahkan kolom Hanya Tanggal atau Tanggal dan waktu. Informasi selengkapnya: Meningkatkan atau memperbarui solusi
Mencegah mengubah perilaku
Jika Anda mendistribusikan kolom tanggal kustom di solusi terkelola, cegah orang yang menggunakan solusi dari mengubah perilaku dengan mengatur properti terkelola CanChangeDateTimeBehavior ke Salah. Informasi lebih lanjut: Atur properti yang dikelola untuk kolom
Operator kueri tanggal dan waktu tidak didukung untuk perilaku Hanya Tanggal
Operator kueri terkait tanggal dan waktu berikut tidak valid untuk perilaku Hanya Tanggal. Kesalahan pengecualian operator tidak valid dibuang ketika salah satu operator ini digunakan dalam kueri.
- Lebih dari X Menit
- Lebih Lama dari X Jam
- X Jam Terakhir
- X Jam Berikutnya
Baca juga
Memecahkan masalah tanggal dan waktu di aplikasi yang diarahkan model
Membuat dan mengedit kolom
Menentukan kolom yang dihitung untuk mengotomatisasi penghitungan manual
Properti yang dikelola kolom
Properti Terkelola
Blog: bekerja dengan zona waktu di Dataverse
Mengonfigurasi perilaku dan format kolom tanggal dan waktu menggunakan kode