Fungsi EnumDateFormatsA (winnls.h)

Artikel
11/20/2024

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.

Sintaksis

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

Mengembalikan nilai

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.

Komentar

Note 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 di EnumDateFormatsEx.

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

Nota

Header winnls.h mendefinisikan EnumDateFormats sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

EnumDateFormatsEx

EnumDateFormatsExEx

EnumDateFormatsProc

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

Bagikan melalui