Funzione EnumDateFormatsA (winnls.h)

Enumera i formati di data lunga, data breve o anno/mese disponibili per le impostazioni locali specificate.

Nota Per ricevere un identificatore di calendario oltre alle informazioni sul formato data, l'applicazione deve usare la funzione EnumDateFormatsEx . Un altro motivo per preferire questa funzione è che Microsoft sta eseguendo la migrazione verso l'uso dei nomi delle impostazioni locali anziché degli identificatori delle impostazioni locali per le nuove impostazioni locali, per motivi di interoperabilità.

 

Nota Qualsiasi applicazione che verrà eseguita solo in Windows Vista o versioni successive deve usare EnumDateFormatsExEx in preferenza per EnumDateFormats.

 

Sintassi

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

Parametri

[in] lpDateFmtEnumProc

Puntatore a una funzione di callback definita dall'applicazione. Per altre informazioni, vedere EnumDateFormatsProc.

[in] Locale

Identificatore delle impostazioni locali che specifica le impostazioni locali per cui recuperare le informazioni sul formato data. È possibile usare la macro MAKELCID per creare un identificatore o usare uno dei valori predefiniti seguenti.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED
• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

[in] dwFlags

Contrassegno che specifica i formati di data. Per definizioni dettagliate, vedere il parametro dwFlags di EnumDateFormatsExEx.

Valore restituito

Restituisce un valore diverso da zero se ha esito positivo o 0 in caso contrario. Per ottenere informazioni sull'errore estese, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

• ERROR_INVALID_FLAGS. I valori forniti per i flag non sono validi.
• ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Commenti

Nota Questa API viene aggiornata per supportare la modifica dell'era giapponese di maggio 2019. Se l'applicazione supporta il calendario giapponese, è necessario verificare che gestisca correttamente la nuova era. Per altre informazioni, vedere Preparare l'applicazione per la modifica dell'era giapponese .

 

Per informazioni dettagliate sull'operazione di questa funzione, vedere Osservazioni in EnumDateFormatsEx.

Nota Per enumerare i formati di data per le impostazioni locali con calendari alternativi, l'applicazione deve usare EnumDateFormatsEx.

 

Nota

L'intestazione winnls.h definisce EnumDateFormats come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

EnumDateFormatsEx

EnumDateFormatsExEx

EnumDateFormatsProc

Supporto per la lingua nazionale

Funzioni di supporto del linguaggio nazionale