Fungsi EnumDateFormatsExA (winnls.h)

Artikel
08/27/2023

Menghitung format tanggal panjang, tanggal pendek, atau tahun/bulan yang tersedia untuk lokal tertentu.

Catatan Aplikasi apa pun yang hanya berjalan pada Windows Vista dan yang lebih baru harus menggunakan EnumDateFormatsExEx di preferensi fungsi ini.

Sintaks

BOOL EnumDateFormatsExA(
  [in] DATEFMT_ENUMPROCEXA lpDateFmtEnumProcEx,
  [in] LCID                Locale,
  [in] DWORD               dwFlags
);

Parameter

[in] lpDateFmtEnumProcEx

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

[in] Locale

Pengidentifikasi lokal yang menentukan lokal untuk mengambil informasi format tanggal. Anda dapat menggunakan makro MAKELCID untuk membuat pengidentifikasi atau menggunakan salah satu nilai yang telah ditentukan sebelumnya berikut ini.

Windows Vista dan yang lebih baru: Pengidentifikasi lokal kustom berikut ini juga didukung.

[in] dwFlags

Bendera yang menentukan format tanggal. Untuk definisi terperinci, lihat parameter dwFlagsenumDateFormatsExEx.

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_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. Proses ini berlanjut hingga EnumDateFormatsEx menemukan format tanggal terakhir atau fungsi panggilan balik mengembalikan FALSE.

Fungsi ini menghitung semua format tanggal untuk lokal yang ditentukan, termasuk kalender alternatif, jika ada. Namun, pengidentifikasi kalender tidak dijumlahkan bersama dengan format tanggal, membuat format untuk lokal dengan kalender alternatif sulit digunakan.

Fungsi ini dapat menghitung data dari lokal kustom. Data tidak dijamin sama dari komputer ke komputer atau antara eksekusi aplikasi. Jika aplikasi Anda harus mempertahankan atau mengirimkan data, lihat Menggunakan Data Lokal Persisten.

Ketika versi ANSI dari fungsi ini digunakan dengan pengidentifikasi lokal khusus Unicode, fungsi dapat berhasil karena sistem operasi menggunakan halaman kode sistem. Namun, karakter yang tidak ditentukan di halaman kode sistem muncul dalam string sebagai tanda tanya (?).

Aplikasi harus menggunakan EnumDateFormatsEx (bukan EnumDateFormats) untuk menghitung format tanggal untuk lokal dengan kalender alternatif.

Catatan

Header winnls.h mendefinisikan EnumDateFormatsEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll