Imagens de formato dia, mês, ano e era

  • Artigo

O aplicativo usa os elementos descritos neste tópico para construir uma cadeia de caracteres de imagem de formato terminada em nulo. Se espaços forem usados para separar os elementos na cadeia de caracteres, esses espaços aparecerão no mesmo local na cadeia de caracteres de saída.

Observação

Os tipos de formato "d", "g" e "y" devem ser minúsculos e a letra "M" deve ser maiúscula.

 

Por exemplo, para obter a cadeia de caracteres de data "Wed, Ago 31 94", o aplicativo usa a cadeia de caracteres de imagem "ddd',' MMM dd yy".

O aplicativo usa aspas simples para marcar caracteres para exibir exatamente como especificado. Se o aplicativo precisar exibir uma única aspa, ele deverá colocar duas aspas simples em uma linha. Por exemplo, 'abc''bar', é exibido como "abc'bar".

A tabela a seguir define os tipos de formato usados para representar dias.

Tipo de formato Significado
d Dia do mês como dígitos sem zeros à esquerda para dias de dígito único.
dd Dia do mês como dígitos com zeros à esquerda para dias de dígito único.
ddd Dia abreviado da semana, conforme especificado por um valor LOCALE_SABBREVDAYNAME*, por exemplo, "Mon" em inglês (Estados Unidos). Windows Vista e posterior: se uma versão curta do dia da semana for necessária, seu aplicativo deverá usar as constantes LOCALE_SSHORTESTDAYNAME*.
dddd Dia da semana, conforme especificado por um valor LOCALE_SDAYNAME* .

 

A tabela a seguir define os tipos de formato usados para representar meses.

Tipo de formato Significado
M Mês como dígitos sem zeros à esquerda para meses de dígito único.
MM Mês como dígitos com zeros à esquerda para meses de dígito único.
MMM Mês abreviado conforme especificado por um valor LOCALE_SABBREVMONTHNAME*, por exemplo, "Nov" em inglês (Estados Unidos).
MMMM Mês conforme especificado por um valor LOCALE_SMONTHNAME*, por exemplo, "Novembro" para inglês (Estados Unidos) e "Noviembre" para espanhol (Espanha).

 

A tabela a seguir define os tipos de formato usados para representar anos.

Tipo de formato Significado
a Ano representado apenas pelo último dígito.
yy Ano representado apenas pelos dois últimos dígitos. Um zero à esquerda é adicionado para anos de dígito único.
yyyy Ano representado por quatro ou cinco dígitos completos, dependendo do calendário usado. Calendários budistas tailandeses e coreanos têm anos de cinco dígitos. O padrão "aaaa" mostra cinco dígitos para esses dois calendários e quatro dígitos para todos os outros calendários com suporte. Calendários que têm anos de dígito único ou dois dígitos, como para a era imperador japonês, são representados de forma diferente. Um ano de dígito único é representado com um zero à esquerda, por exemplo, "03". Um ano de dois dígitos é representado com dois dígitos, por exemplo, "13". Nenhum zero à esquerda adicional é exibido.
yyyyy Comporta-se de forma idêntica a "aaaa".

 

A tabela a seguir define os tipos de formato usados para representar um período ou era.

Tipo de formato Significado
g, gg Cadeia de caracteres de período/era formatada conforme especificado pelo valor CAL_SERASTRING. As imagens de formato "g" e "gg" em uma cadeia de caracteres de data serão ignoradas se não houver nenhuma era ou cadeia de caracteres de período associada.