Informações de tipo de calendário
Este tópico descreve as informações de tipo de calendário (tipo de dados CALTYPE) usadas nas funções EnumCalendarInfo, EnumCalendarInfoEx, EnumCalendarInfoExEx, GetCalendarInfo e GetCalendarInfoEx . Alguns desses valores também são usados pela função SetCalendarInfo .
As seguintes constantes CALTYPE podem ser usadas em combinação com qualquer outra constante CALTYPE.
| Constante | Descrição |
|---|---|
| CAL_NOUSEROVERRIDE | Windows Me/98, Windows 2000: Use o padrão do sistema em vez da escolha do usuário. |
| CAL_RETURN_GENITIVE_NAMES | Windows 7 e posterior: Recupere o resultado de GetCalendarInfo na forma de nomes congênitos de meses, que são os nomes usados quando os nomes de mês são combinados com outros itens. Por exemplo, em ucraniano, o equivalente a janeiro é escrito "Січень" quando o mês é nomeado sozinho. No entanto, quando o nome do mês é usado em combinação, por exemplo, em uma data como 5 de janeiro de 2003, a forma congênita do nome é usada. Para o exemplo ucraniano, o nome do mês congênito é exibido como "5 січня 2003". Para obter mais informações, consulte LOCALE_RETURN_GENITIVE_NAMES. |
| CAL_RETURN_NUMBER | Windows Me/98, Windows 2000: Recupere o resultado de GetCalendarInfo como um número em vez de uma cadeia de caracteres. Isso só é válido para valores que começam com CAL_I. |
| CAL_USE_CP_ACP | Windows Me/98, Windows 2000: Use a ACP (página de código ANSI) do sistema em vez da página de código de localidade para tradução de cadeia de caracteres. Isso só é relevante para versões ANSI de funções, por exemplo, EnumCalendarInfoA. |
As seguintes constantes CALTYPE são mutuamente exclusivas e não podem ser usadas em combinação entre si em uma chamada de função.
| Constante | Descrição |
|---|---|
| CAL_ICALINTVALUE | Um valor inteiro que indica o tipo de calendário do calendário alternativo. |
| CAL_ITWODIGITYEARMAX | Windows Me/98, Windows 2000: Um valor inteiro que indica o limite superior do intervalo de ano de dois dígitos. |
| CAL_IYEAROFFSETRANGE | Uma ou mais cadeias de caracteres terminadas em nulo que especificam os deslocamentos de ano para cada um dos intervalos de era. A última cadeia de caracteres tem um caractere nulo de terminação extra. Esse valor varia de acordo com o formato, dependendo do tipo de calendário opcional. |
| CAL_SABBREVDAYNAME1 | Nome nativo abreviado do primeiro dia da semana. |
| CAL_SABBREVDAYNAME2 | Nome nativo abreviado do segundo dia da semana. |
| CAL_SABBREVDAYNAME3 | Nome nativo abreviado do terceiro dia da semana. |
| CAL_SABBREVDAYNAME4 | Nome nativo abreviado do quarto dia da semana. |
| CAL_SABBREVDAYNAME5 | Nome nativo abreviado do quinto dia da semana. |
| CAL_SABBREVDAYNAME6 | Nome nativo abreviado do sexto dia da semana. |
| CAL_SABBREVDAYNAME7 | Nome nativo abreviado do sétimo dia da semana. |
| CAL_SABBREVERASTRING | Windows 7 e posterior: Nome nativo abreviado de uma era. A era completa é representada pela constante CAL_SERASTRING. |
| CAL_SABBREVMONTHNAME1 | Nome nativo abreviado do primeiro mês do ano. |
| CAL_SABBREVMONTHNAME2 | Nome nativo abreviado do segundo mês do ano. |
| CAL_SABBREVMONTHNAME3 | Nome nativo abreviado do terceiro mês do ano. |
| CAL_SABBREVMONTHNAME4 | Nome nativo abreviado do quarto mês do ano. |
| CAL_SABBREVMONTHNAME5 | Nome nativo abreviado do quinto mês do ano. |
| CAL_SABBREVMONTHNAME6 | Nome nativo abreviado do sexto mês do ano. |
| CAL_SABBREVMONTHNAME7 | Nome nativo abreviado do sétimo mês do ano. |
| CAL_SABBREVMONTHNAME8 | Nome nativo abreviado do oitavo mês do ano. |
| CAL_SABBREVMONTHNAME9 | Nome nativo abreviado do nono mês do ano. |
| CAL_SABBREVMONTHNAME10 | Nome nativo abreviado do décimo mês do ano. |
| CAL_SABBREVMONTHNAME11 | Nome nativo abreviado do décimo primeiro mês do ano. |
| CAL_SABBREVMONTHNAME12 | Nome nativo abreviado do décimo segundo mês do ano. |
| CAL_SABBREVMONTHNAME13 | Nome nativo abreviado do décimo terceiro mês do ano, se existir. |
| CAL_SCALNAME | Nome nativo do calendário alternativo. |
| CAL_SDAYNAME1 | Nome nativo do primeiro dia da semana. |
| CAL_SDAYNAME2 | Nome nativo do segundo dia da semana. |
| CAL_SDAYNAME3 | Nome nativo do terceiro dia da semana. |
| CAL_SDAYNAME4 | Nome nativo do quarto dia da semana. |
| CAL_SDAYNAME5 | Nome nativo do quinto dia da semana. |
| CAL_SDAYNAME6 | Nome nativo do sexto dia da semana. |
| CAL_SDAYNAME7 | Nome nativo do sétimo dia da semana. |
| CAL_SERASTRING | Uma ou mais cadeias de caracteres terminadas em nulo que especificam cada um dos pontos de código Unicode especificando a era associada a CAL_IYEAROFFSETRANGE. A última cadeia de caracteres tem um caractere nulo de terminação extra. Esse valor varia de acordo com o formato, dependendo do tipo de calendário opcional. |
| CAL_SLONGDATE | Formatos de data longos para o tipo de calendário. |
| CAL_SMONTHDAY |
Windows 7 e posterior: Formato do mês e do dia para o tipo de calendário. A formatação é semelhante à de CAL_SLONGDATE. Por exemplo, se o padrão Mês/Dia for o nome do mês completo seguido pelo número do dia com zeros à esquerda, por exemplo, "03 de setembro", o formato será "MMMM dd". Aspas simples podem ser usadas para inserir caracteres não formatados, por exemplo, 'de' em espanhol.
Nota: Esse tipo de calendário dá suporte a apenas um formato. |
| CAL_SMONTHNAME1 | Nome nativo do primeiro mês do ano. |
| CAL_SMONTHNAME2 | Nome nativo do segundo mês do ano. |
| CAL_SMONTHNAME3 | Nome nativo do terceiro mês do ano. |
| CAL_SMONTHNAME4 | Nome nativo do quarto mês do ano. |
| CAL_SMONTHNAME5 | Nome nativo do quinto mês do ano. |
| CAL_SMONTHNAME6 | Nome nativo do sexto mês do ano. |
| CAL_SMONTHNAME7 | Nome nativo do sétimo mês do ano. |
| CAL_SMONTHNAME8 | Nome nativo do oitavo mês do ano. |
| CAL_SMONTHNAME9 | Nome nativo do nono mês do ano. |
| CAL_SMONTHNAME10 | Nome nativo do décimo mês do ano. |
| CAL_SMONTHNAME11 | Nome nativo do décimo primeiro mês do ano. |
| CAL_SMONTHNAME12 | Nome nativo do décimo segundo mês do ano. |
| CAL_SMONTHNAME13 | Nome nativo do décimo terceiro mês do ano, se existir. |
| CAL_SSHORTDATE | Formatos de data curto para o tipo de calendário. |
| CAL_SSHORTESTDAYNAME1 | Windows Vista e posterior: Nome nativo curto do primeiro dia da semana. |
| CAL_SSHORTESTDAYNAME2 | Windows Vista e posterior: Nome nativo curto do segundo dia da semana. |
| CAL_SSHORTESTDAYNAME3 | Windows Vista e posterior: Nome nativo curto do terceiro dia da semana. |
| CAL_SSHORTESTDAYNAME4 | Windows Vista e posterior: Nome nativo curto do quarto dia da semana. |
| CAL_SSHORTESTDAYNAME5 | Windows Vista e posterior: Nome nativo curto do quinto dia da semana. |
| CAL_SSHORTESTDAYNAME6 | Windows Vista e posterior: Nome nativo curto do sexto dia da semana. |
| CAL_SSHORTESTDAYNAME7 | Windows Vista e posterior: Nome nativo curto do sétimo dia da semana. |
| CAL_SYEARMONTH | Windows Me/98, Windows 2000: Os formatos de ano/mês para os calendários especificados. |
Observação
Se o nome nativo do dia da semana ou de um mês for uma cadeia de caracteres vazia, esse nome será idêntico ao nome especificado nas informações de localidade correspondentes e, portanto, não será duplicado aqui.