Fungsi EnumDateFormatsA (winnls.h)

Artikel
08/27/2023

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

Catatan Untuk menerima pengidentifikasi kalender selain informasi format tanggal, aplikasi harus menggunakan fungsi EnumDateFormatsEx . Alasan lain untuk lebih memilih fungsi ini adalah bahwa Microsoft bermigrasi ke penggunaan nama lokal alih-alih pengidentifikasi lokal untuk lokal baru, karena alasan interoperabilitas.

Catatan Aplikasi apa pun yang hanya akan dijalankan di Windows Vista atau yang lebih baru harus menggunakan EnumDateFormatsExEx disukai enumDateFormats.

Sintaks

BOOL EnumDateFormatsA(
  [in] DATEFMT_ENUMPROCA lpDateFmtEnumProc,
  [in] LCID              Locale,
  [in] DWORD             dwFlags
);

Parameter

[in] lpDateFmtEnumProc

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

[in] Locale

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

[in] dwFlags

Bendera yang menentukan format tanggal. Untuk definisi terperinci, lihat parameter dwFlags dari EnumDateFormatsExEx.

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 diberikan 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.

Untuk detail operasi fungsi ini, lihat Keterangan dalam EnumDateFormatsEx.

Catatan Untuk menghitung format tanggal untuk lokal dengan kalender alternatif, aplikasi harus menggunakan EnumDateFormatsEx.

Catatan

Header winnls.h mendefinisikan EnumDateFormats 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