EnumDateFormats (Windows CE 5.0)

  • Article

Send Feedback

This function enumerates the long or short date formats that are available for a specified locale, including date formats for any alternate calendars.

BOOLEnumDateFormats(DATEFMT_ENUMPROClpDateFmtEnumProc, LCIDLocale, DWORDdwFlags);

Parameters

  • lpDateFmtEnumProc
    [in] Pointer to an application-defined callback function. The EnumDateFormats function enumerates date formats by making repeated calls to this callback function. For more information, see the EnumDateFormatsProc callback function.
  • Locale
    [in] Value that specifies the locale to retrieve date format information for. This parameter can be a locale identifier created by the MAKELCID macro, or one of the following predefined values. The following table shows the values this parameter can take.
    Value Description
    LOCALE_SYSTEM_DEFAULT Default system locale.
    LOCALE_USER_DEFAULT Default user locale.
    LOCALE_NEUTRAL Default language-neutral locale.
  • dwFlags
    [in] Value that specifies the date formats that are of interest. The following table shows the values this parameter can take.
    Value Description
    DATE_SHORTDATE Return short date formats.
    DATE_LONGDATE Return long date formats.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call the GetLastError function. The following table shows possible return values for the GetLastError function**.**

Value Description
ERROR_BADDB The configuration registry database is corrupt.
ERROR_INVALID FLAGS The flags are invalid.
ERROR_INVALID_PARAMETER The parameter is incorrect.

Remarks

For more information about LCID, see National Language support (NLS) Locale Identifiers.

The DATE_SHORTDATE and DATE_LONGDATE flags are mutually exclusive. Use one or the other, but not both.

For Microsoft Windows CE 2.10 and later, default DATE_SHORTDATE formats for non-U.S. English locales that include the four-digit year are added. The following table shows the formats.

Locale Date Format
United Kingdom dd/MM/yyyy
Canada dd/MM/yyyy
New Zealand dd/MM/yyyy
Ireland dd/MM/yyyy
South Africa dd/MM/yyyy
Caribbean MM/dd/yyyy
Belize dd/MM/yyyy
Trinidad dd/MM/yyyy

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Winnls.h.
Link Library: Coreloc.lib.

See Also

National Language support (NLS) Locale Identifiers | EnumCalendarInfo | EnumDateFormatsProc | EnumTimeFormats | MAKELCID

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.