Memformat nilai DateTime
Nilai Azure Storage DateTime harus direpresentasikan sebagai gabungan nilai Waktu Universal Terkoordinasi (UTC). Format UTC dijelaskan oleh ISO 8601.
Format ISO 8601 UTC yang diterima
Format ISO 8601 UTC berikut saat ini diterima oleh Azure Storage. Nilai tanggal diperlukan, sementara nilai waktu bersifat opsional:
YYYY-MM-DDYYYY-MM-DDThh:mm<TZDSuffix>YYYY-MM-DDThh:mm:ss<TZDSuffix>
Untuk nilai tanggal dalam format ini, YYYY adalah representasi tahun empat digit, MM adalah representasi bulan dua digit mulai dari 1, dan DD merupakan representasi hari dua digit mulai dari 1.
Jika nilai waktu opsional disertakan, penanda T harfiah diperlukan untuk memisahkan nilai waktu dari nilai tanggal. Untuk nilai waktu, hh adalah representasi jam dalam notasi 24 jam, mm adalah representasi menit dua digit, dan ss merupakan representasi kedua dua digit. Masing-masing nilai ini dinyatakan sebagai bilangan bulat, dimulai dari nol.
Jika nilai waktu menyertakan detik, secara opsional juga dapat menyertakan hingga 7 digit desimal detik pecahan, mengikuti pola hh:mm:ss[.f{1,7}]. Pola ini didukung oleh API, alat, dan pustaka klien Azure Storage. Anda harus menggunakan titik daripada koma untuk menguraikan nilai detik pecahan.
Jika Anda menyertakan akhiran <TZDSuffix>zona waktu opsional , itu harus dinyatakan sebagai:
- Nilai
Zharfiah , yang menunjuk bahwa nilai waktu dinyatakan sebagai waktu UTC; atau - Offset yang menunjukkan bias waktu dari waktu UTC. Offset membutuhkan memimpin
+untuk offset positif dan memimpin-untuk offset negatif. Nilai offset harus berada di antara -23:59 dan +23:59.
Contoh format UTC gabungan ditunjukkan di bawah ini. Tanggal ditentukan terlebih dahulu, diikuti oleh nilai Tharfiah , yang menunjuk awal elemen waktu. Nilai harfiah Z di akhir string menunjukkan bahwa waktu dinyatakan dalam UTC.
Nilai tanggal/waktu untuk 16 November 2020 pukul 04.25.03 dalam waktu UTC dinyatakan sebagai:
2020-11-16T04:25:03Z
Untuk mengekspresikan waktu yang sama di Waktu Standar Timur (EST), yaitu lima jam sebelumnya UTC tersebut, tambahkan offset ke nilai:
2020-11-16T04:25:03-05:00