Export (0) Print
Expand All

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.

ConstantDescription
CAL_NOUSEROVERRIDEWindows Me/98, Windows 2000: Use the system default instead of the user's choice.
CAL_RETURN_GENITIVE_NAMESWindows 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_NUMBERWindows 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_ACPWindows 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.

ConstantDescription
CAL_ICALINTVALUEAn integer value indicating the calendar type of the alternate calendar.
CAL_ITWODIGITYEARMAXWindows Me/98, Windows 2000: An integer value indicating the upper boundary of the two-digit year range.
CAL_IYEAROFFSETRANGEOne 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_SABBREVDAYNAME1Abbreviated native name of the first day of the week.
CAL_SABBREVDAYNAME2Abbreviated native name of the second day of the week.
CAL_SABBREVDAYNAME3Abbreviated native name of the third day of the week.
CAL_SABBREVDAYNAME4Abbreviated native name of the fourth day of the week.
CAL_SABBREVDAYNAME5Abbreviated native name of the fifth day of the week.
CAL_SABBREVDAYNAME6Abbreviated native name of the sixth day of the week.
CAL_SABBREVDAYNAME7Abbreviated native name of the seventh day of the week.
CAL_SABBREVERASTRINGWindows 7 and later: Abbreviated native name of an era. The full era is represented by the CAL_SERASTRING constant.
CAL_SABBREVMONTHNAME1Abbreviated native name of the first month of the year.
CAL_SABBREVMONTHNAME2Abbreviated native name of the second month of the year.
CAL_SABBREVMONTHNAME3Abbreviated native name of the third month of the year.
CAL_SABBREVMONTHNAME4Abbreviated native name of the fourth month of the year.
CAL_SABBREVMONTHNAME5Abbreviated native name of the fifth month of the year.
CAL_SABBREVMONTHNAME6Abbreviated native name of the sixth month of the year.
CAL_SABBREVMONTHNAME7Abbreviated native name of the seventh month of the year.
CAL_SABBREVMONTHNAME8Abbreviated native name of the eighth month of the year.
CAL_SABBREVMONTHNAME9Abbreviated native name of the ninth month of the year.
CAL_SABBREVMONTHNAME10Abbreviated native name of the tenth month of the year.
CAL_SABBREVMONTHNAME11Abbreviated native name of the eleventh month of the year.
CAL_SABBREVMONTHNAME12Abbreviated native name of the twelfth month of the year.
CAL_SABBREVMONTHNAME13Abbreviated native name of the thirteenth month of the year, if it exists.
CAL_SCALNAMENative name of the alternate calendar.
CAL_SDAYNAME1Native name of the first day of the week.
CAL_SDAYNAME2Native name of the second day of the week.
CAL_SDAYNAME3Native name of the third day of the week.
CAL_SDAYNAME4Native name of the fourth day of the week.
CAL_SDAYNAME5Native name of the fifth day of the week.
CAL_SDAYNAME6Native name of the sixth day of the week.
CAL_SDAYNAME7Native name of the seventh day of the week.
CAL_SERASTRINGOne 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_SLONGDATELong date formats for the calendar type.
CAL_SMONTHDAYWindows 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_SMONTHNAME1Native name of the first month of the year.
CAL_SMONTHNAME2Native name of the second month of the year.
CAL_SMONTHNAME3Native name of the third month of the year.
CAL_SMONTHNAME4Native name of the fourth month of the year.
CAL_SMONTHNAME5Native name of the fifth month of the year.
CAL_SMONTHNAME6Native name of the sixth month of the year.
CAL_SMONTHNAME7Native name of the seventh month of the year.
CAL_SMONTHNAME8Native name of the eighth month of the year.
CAL_SMONTHNAME9Native name of the ninth month of the year.
CAL_SMONTHNAME10Native name of the tenth month of the year.
CAL_SMONTHNAME11Native name of the eleventh month of the year.
CAL_SMONTHNAME12Native name of the twelfth month of the year.
CAL_SMONTHNAME13Native name of the thirteenth month of the year, if it exists.
CAL_SSHORTDATEShort date formats for the calendar type.
CAL_SSHORTESTDAYNAME1Windows Vista and later: Short native name of the first day of the week.
CAL_SSHORTESTDAYNAME2Windows Vista and later: Short native name of the second day of the week.
CAL_SSHORTESTDAYNAME3Windows Vista and later: Short native name of the third day of the week.
CAL_SSHORTESTDAYNAME4Windows Vista and later: Short native name of the fourth day of the week.
CAL_SSHORTESTDAYNAME5Windows Vista and later: Short native name of the fifth day of the week.
CAL_SSHORTESTDAYNAME6Windows Vista and later: Short native name of the sixth day of the week.
CAL_SSHORTESTDAYNAME7Windows Vista and later: Short native name of the seventh day of the week.
CAL_SYEARMONTHWindows 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.

 

 

Community Additions

ADD
Show:
© 2014 Microsoft