Calendar Type Information

This topic describes the calendar type information (CALTYPE data type) used in the EnumCalendarInfo, EnumCalendarInfoEx, EnumCalendarInfoExEx, GetCalendarInfo, and GetCalendarInfoEx functions. Some of these values are also used by the SetCalendarInfo function.

The following CALTYPE constants can be used in combination with any other CALTYPE constants.

Constant Description
CAL_NOUSEROVERRIDE Windows Me/98, Windows 2000: Use the system default instead of the user's choice.
CAL_RETURN_GENITIVE_NAMES Windows 7 and later: Retrieve the result from GetCalendarInfo in the form of genitive names of months, which are the names used when the month names are combined with other items. For example, in Ukrainian the equivalent of January is written "Січень" when the month is named alone. However, when the month name is used in combination, for example, in a date such as January 5th, 2003, the genitive form of the name is used. For the Ukrainian example, the genitive month name is displayed as "5 січня 2003". For more information, see LOCALE_RETURN_GENITIVE_NAMES.
CAL_RETURN_NUMBER Windows Me/98, Windows 2000: Retrieve the result from GetCalendarInfo as a number instead of a string. This is only valid for values beginning with CAL_I.
CAL_USE_CP_ACP Windows Me/98, Windows 2000: Use the system ANSI code page (ACP) instead of the locale code page for string translation. This is only relevant for ANSI versions of functions, for example, EnumCalendarInfoA.

 

The following CALTYPE constants are mutually exclusive and cannot be used in combination with each other in a function call.

Constant Description
CAL_ICALINTVALUE An integer value indicating the calendar type of the alternate calendar.
CAL_ITWODIGITYEARMAX Windows Me/98, Windows 2000: An integer value indicating the upper boundary of the two-digit year range.
CAL_IYEAROFFSETRANGE One or more null-terminated strings that specify the year offsets for each of the era ranges. The last string has an extra terminating null character. This value varies in format depending on the type of optional calendar.
CAL_SABBREVDAYNAME1 Abbreviated native name of the first day of the week.
CAL_SABBREVDAYNAME2 Abbreviated native name of the second day of the week.
CAL_SABBREVDAYNAME3 Abbreviated native name of the third day of the week.
CAL_SABBREVDAYNAME4 Abbreviated native name of the fourth day of the week.
CAL_SABBREVDAYNAME5 Abbreviated native name of the fifth day of the week.
CAL_SABBREVDAYNAME6 Abbreviated native name of the sixth day of the week.
CAL_SABBREVDAYNAME7 Abbreviated native name of the seventh day of the week.
CAL_SABBREVERASTRING Windows 7 and later: Abbreviated native name of an era. The full era is represented by the CAL_SERASTRING constant.
CAL_SABBREVMONTHNAME1 Abbreviated native name of the first month of the year.
CAL_SABBREVMONTHNAME2 Abbreviated native name of the second month of the year.
CAL_SABBREVMONTHNAME3 Abbreviated native name of the third month of the year.
CAL_SABBREVMONTHNAME4 Abbreviated native name of the fourth month of the year.
CAL_SABBREVMONTHNAME5 Abbreviated native name of the fifth month of the year.
CAL_SABBREVMONTHNAME6 Abbreviated native name of the sixth month of the year.
CAL_SABBREVMONTHNAME7 Abbreviated native name of the seventh month of the year.
CAL_SABBREVMONTHNAME8 Abbreviated native name of the eighth month of the year.
CAL_SABBREVMONTHNAME9 Abbreviated native name of the ninth month of the year.
CAL_SABBREVMONTHNAME10 Abbreviated native name of the tenth month of the year.
CAL_SABBREVMONTHNAME11 Abbreviated native name of the eleventh month of the year.
CAL_SABBREVMONTHNAME12 Abbreviated native name of the twelfth month of the year.
CAL_SABBREVMONTHNAME13 Abbreviated native name of the thirteenth month of the year, if it exists.
CAL_SCALNAME Native name of the alternate calendar.
CAL_SDAYNAME1 Native name of the first day of the week.
CAL_SDAYNAME2 Native name of the second day of the week.
CAL_SDAYNAME3 Native name of the third day of the week.
CAL_SDAYNAME4 Native name of the fourth day of the week.
CAL_SDAYNAME5 Native name of the fifth day of the week.
CAL_SDAYNAME6 Native name of the sixth day of the week.
CAL_SDAYNAME7 Native name of the seventh day of the week.
CAL_SERASTRING One or more null-terminated strings that specify each of the Unicode code points specifying the era associated with CAL_IYEAROFFSETRANGE. The last string has an extra terminating null character. This value varies in format depending on the type of optional calendar.
CAL_SLONGDATE Long date formats for the calendar type.
CAL_SMONTHDAY Windows 7 and later: Format of the month and day for the calendar type. The formatting is similar to that for CAL_SLONGDATE. For example, if the Month/Day pattern is the full month name followed by the day number with leading zeros, for example, "September 03", the format is "MMMM dd". Single quotation marks can be used to insert non-format characters, for example, 'de' in Spanish.
[!Note]
This calendar type supports only one format.

CAL_SMONTHNAME1 Native name of the first month of the year.
CAL_SMONTHNAME2 Native name of the second month of the year.
CAL_SMONTHNAME3 Native name of the third month of the year.
CAL_SMONTHNAME4 Native name of the fourth month of the year.
CAL_SMONTHNAME5 Native name of the fifth month of the year.
CAL_SMONTHNAME6 Native name of the sixth month of the year.
CAL_SMONTHNAME7 Native name of the seventh month of the year.
CAL_SMONTHNAME8 Native name of the eighth month of the year.
CAL_SMONTHNAME9 Native name of the ninth month of the year.
CAL_SMONTHNAME10 Native name of the tenth month of the year.
CAL_SMONTHNAME11 Native name of the eleventh month of the year.
CAL_SMONTHNAME12 Native name of the twelfth month of the year.
CAL_SMONTHNAME13 Native name of the thirteenth month of the year, if it exists.
CAL_SSHORTDATE Short date formats for the calendar type.
CAL_SSHORTESTDAYNAME1 Windows Vista and later: Short native name of the first day of the week.
CAL_SSHORTESTDAYNAME2 Windows Vista and later: Short native name of the second day of the week.
CAL_SSHORTESTDAYNAME3 Windows Vista and later: Short native name of the third day of the week.
CAL_SSHORTESTDAYNAME4 Windows Vista and later: Short native name of the fourth day of the week.
CAL_SSHORTESTDAYNAME5 Windows Vista and later: Short native name of the fifth day of the week.
CAL_SSHORTESTDAYNAME6 Windows Vista and later: Short native name of the sixth day of the week.
CAL_SSHORTESTDAYNAME7 Windows Vista and later: Short native name of the seventh day of the week.
CAL_SYEARMONTH Windows Me/98, Windows 2000: The year/month formats for the specified calendars.

 

Note

If the native name for the day of the week or for a month is an empty string, that name is identical to the name specified in the corresponding locale information and therefore is not duplicated here.