Fungsi SHFormatDateTimeW (shlwapi.h)

[SHFormatDateTime tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Menghasilkan representasi string dari waktu yang ditentukan sebagai struktur FILETIME.

Sintaksis

C++

int SHFormatDateTimeW(
  [in]                const FILETIME *pft,
  [in, out, optional] DWORD          *pdwFlags,
  [out]               LPWSTR         pszBuf,
                      UINT           cchBuf
);

Parameter

[in] pft

Jenis: const FILETIME UNALIGNED*

Penunjuk ke struktur FILETIME yang waktunya akan dikonversi menjadi string.

[in, out, optional] pdwFlags

Jenis: DWORD*

Penunjuk ke nilai DWORD yang berisi bendera bitwise yang menentukan format tanggal dan waktu.

Saat Anda memanggil fungsi, Anda dapat menggabungkan nol atau lebih dari bendera berikut, dengan pengecualian seperti yang disebutkan. Anda juga dapat mengatur parameter ini ke NULL, dalam hal ini fungsi mengasumsikan bahwa bendera FDTF_DEFAULT diatur.

FDTF_SHORTTIME (0x00000001)

0x00000001. Memformat waktu hari ini seperti yang ditentukan oleh Opsi Regional dan Bahasa aplikasi di Panel Kontrol, tetapi tanpa detik. Bendera ini tidak dapat digabungkan dengan FDTF_LONGTIME.

Waktu yang singkat berhasil diformat.

FDTF_SHORTDATE (0x00000002)

0x00000002. Memformat tanggal sebagaimana ditentukan oleh format tanggal pendek dalam aplikasi Opsi Regional dan Bahasa di Panel Kontrol. Bendera ini tidak dapat digabungkan dengan FDTF_LONGDATE.

Tanggal pendek berhasil diformat.

FDTF_DEFAULT

Setara dengan FDTF_SHORTDATE | FDTF_SHORTTIME.

FDTF_LONGDATE (0x00000004)

0x00000004. Memformat tanggal sebagaimana ditentukan oleh format tanggal panjang dalam aplikasi Opsi Regional dan Bahasa di Panel Kontrol. Bendera ini tidak dapat digabungkan dengan FDTF_SHORTDATE.

Tanggal panjang berhasil diformat.

FDTF_LONGTIME (0x00000008)

0x00000008. Memformat waktu hari ini seperti yang ditentukan oleh aplikasi Opsi Regional dan Bahasa di Panel Kontrol, termasuk detik. Bendera ini tidak dapat digabungkan dengan FDTF_SHORTTIME.

Waktu yang lama berhasil diformat.

FDTF_RELATIVE (0x00000010)

0x00000010. Jika bendera FDTF_LONGDATE diatur dan tanggal dalam struktur FILETIME adalah tanggal yang sama dengan SHFormatDateTime dipanggil, maka hari dalam seminggu (jika ada) diubah menjadi "Hari Ini". Jika tanggal dalam struktur adalah hari sebelumnya, maka hari dalam seminggu (jika ada) diubah menjadi "Kemarin".

Notasi relatif digunakan untuk tanggal tersebut.

FDTF_LTRDATE (0x00000100)

0x00000100. Menambahkan tanda untuk tata letak baca kiri-ke-kanan. Bendera ini tidak dapat digabungkan dengan FDTF_RTLDATE.

FDTF_RTLDATE (0x00000200)

0x00000200. Menambahkan tanda untuk tata letak baca kanan-ke-kiri. Bendera ini tidak dapat digabungkan dengan FDTF_LTRDATE.

FDTF_NOAUTOREADINGORDER (0x00000400)

0x00000400. Tidak ada tanda urutan pembacaan yang disisipkan. Biasanya, dengan tidak adanya bendera FDTF_LTRDATE atau FDTF_RTLDATE, SHFormatDateTime menentukan urutan baca dari lokal default pengguna, menyisipkan tanda pesanan bacaan, dan memperbarui nilai output pdwFlags dengan tepat. Bendera ini mencegah proses tersebut terjadi. Ini digunakan paling umum oleh penelepon warisan SHFormatDateTime. Bendera ini tidak dapat digabungkan dengan FDTF_RTLDATE atau FDTF_LTRDATE.

Windows Server 2003 dan Windows XP: Nilai ini tidak tersedia.

Saat fungsi kembali, nilai DWORD yang ditujukkan oleh parameter ini dapat berisi nol atau lebih dari bendera berikut.

FDTF_SHORTTIME (0x00000001)

0x00000001. Memformat waktu hari ini seperti yang ditentukan oleh Opsi Regional dan Bahasa aplikasi di Panel Kontrol, tetapi tanpa detik. Bendera ini tidak dapat digabungkan dengan FDTF_LONGTIME.

Waktu yang singkat berhasil diformat.

FDTF_SHORTDATE (0x00000002)

0x00000002. Memformat tanggal sebagaimana ditentukan oleh format tanggal pendek dalam aplikasi Opsi Regional dan Bahasa di Panel Kontrol. Bendera ini tidak dapat digabungkan dengan FDTF_LONGDATE.

Tanggal pendek berhasil diformat.

FDTF_LONGDATE (0x00000004)

0x00000004. Memformat tanggal sebagaimana ditentukan oleh format tanggal panjang dalam aplikasi Opsi Regional dan Bahasa di Panel Kontrol. Bendera ini tidak dapat digabungkan dengan FDTF_SHORTDATE.

Tanggal panjang berhasil diformat.

FDTF_LONGTIME (0x00000008)

0x00000008. Memformat waktu hari ini seperti yang ditentukan oleh aplikasi Opsi Regional dan Bahasa di Panel Kontrol, termasuk detik. Bendera ini tidak dapat digabungkan dengan FDTF_SHORTTIME.

Waktu yang lama berhasil diformat.

FDTF_RELATIVE (0x00000010)

0x00000010. Jika bendera FDTF_LONGDATE diatur dan tanggal dalam struktur FILETIME adalah tanggal yang sama dengan SHFormatDateTime dipanggil, maka hari dalam seminggu (jika ada) diubah menjadi "Hari Ini". Jika tanggal dalam struktur adalah hari sebelumnya, maka hari dalam seminggu (jika ada) diubah menjadi "Kemarin".

Notasi relatif digunakan untuk tanggal tersebut.

[out] pszBuf

Jenis: LPTSTR

Penunjuk ke buffer yang menerima tanggal dan waktu yang diformat. Buffer harus cukup besar untuk berisi jumlah karakter TCHAR yang ditentukan oleh parameter cchBuf, termasuk karakter null yang mengakhiri.

cchBuf

Jenis: UINT

Jumlah TCHAR yang dapat dimuat oleh buffer yang ditujukkan oleh pszBuf.

Mengembalikan nilai

Jenis: int

Mengembalikan jumlah TCHAR yang ditulis ke buffer, termasuk karakter null yang mengakhiri. Jika gagal, nilai ini adalah 0.

Komentar

Catatan

Header shlwapi.h mendefinisikan SHFormatDateTime sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 5.0 atau yang lebih baru)

Lihat juga

GetDateFormat

GetTimeFormat