Fungsi EnumDateFormatsExEx (winnls.h)

Artikel
03/08/2023

Menghitung format tanggal panjang, tanggal pendek, atau tahun/bulan yang tersedia untuk lokal yang ditentukan berdasarkan nama.

Catatan Aplikasi harus memanggil fungsi ini sebagai preferensi untuk EnumDateFormats atau EnumDateFormatsEx jika dirancang untuk berjalan hanya pada Windows Vista dan yang lebih baru.

Catatan Fungsi ini dapat menghitung data yang berubah di antara rilis, misalnya, karena lokal kustom. Jika aplikasi Anda harus mempertahankan atau mengirimkan data, lihat Menggunakan Data Lokal Persisten.

Sintaks

BOOL EnumDateFormatsExEx(
  [in]           DATEFMT_ENUMPROCEXEX lpDateFmtEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           DWORD                dwFlags,
  [in]           LPARAM               lParam
);

Parameter

[in] lpDateFmtEnumProcExEx

Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi. Untuk informasi selengkapnya, lihat EnumDateFormatsProcExEx.

[in, optional] lpLocaleName

Arahkan ke nama lokal, atau salah satu nilai yang telah ditentukan sebelumnya berikut ini.

[in] dwFlags

Bendera yang menentukan format tanggal. Aplikasi dapat menyediakan salah satu nilai berikut atau konstanta LOCALE_USE_CP_ACP .

Nilai	Makna
DATE_SHORTDATE	Gunakan format tanggal pendek. Nilai ini tidak dapat digunakan dengan salah satu nilai bendera lainnya.
DATE_LONGDATE	Gunakan format tanggal panjang. Nilai ini tidak dapat digunakan dengan salah satu nilai bendera lainnya.
DATE_YEARMONTH	Gunakan format tahun/bulan. Nilai ini tidak dapat digunakan dengan salah satu nilai bendera lainnya.
DATE_MONTHDAY	Gunakan format bulan/hari. Nilai ini tidak dapat digunakan dengan salah satu nilai bendera lainnya.

[in] lParam

Parameter yang disediakan aplikasi untuk diteruskan ke fungsi panggilan balik. Nilai ini sangat berguna untuk aplikasi multi-utas.

Nilai kembali

Mengembalikan nilai bukan nol jika berhasil, atau 0 sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError, yang dapat mengembalikan salah satu kode kesalahan berikut:

ERROR_BADDB. Fungsi tidak dapat mengakses data. Situasi ini biasanya tidak boleh terjadi, dan biasanya menunjukkan penginstalan yang buruk, masalah disk, atau sejenisnya.
ERROR_INVALID_FLAGS. Nilai yang disediakan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Catatan API ini sedang diperbarui untuk mendukung perubahan era Jepang Mei 2019. Jika aplikasi Anda mendukung kalender Jepang, Anda harus memvalidasi bahwa aplikasi tersebut menangani era baru dengan benar. Lihat Menyiapkan aplikasi Anda untuk perubahan era Jepang untuk informasi selengkapnya.

Fungsi menghitung format tanggal dengan meneruskan penunjuk string format tanggal, satu per satu, ke fungsi panggilan balik yang ditentukan aplikasi yang ditentukan, bersama dengan konstanta yang ditentukan aplikasi yang berguna untuk aplikasi multi-utas. Proses ini berlanjut hingga EnumDateFormatsExEx menemukan format tanggal terakhir atau fungsi panggilan balik mengembalikan FALSE.

Dimulai di Windows 8: Jika aplikasi Anda meneruskan tag bahasa ke fungsi ini dari namespace Windows.Globalization, aplikasi harus terlebih dahulu mengonversi tag dengan memanggil ResolveLocaleName.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll