Função CMOY( )
Retorna o nome do mês do ano para uma data ou datahora especificada. Abreviação de "Caractere para o Mês do Ano".
Sintaxe
CMOY(data/datahora; comprimento)
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
data/datahora |
datahora |
O campo, expressão ou valor literal do qual será obtido o nome do mês. |
comprimento |
numérico |
Um valor entre 1 e 9 que especifica o comprimento da cadeia de saída. Para exibir nomes de mês abreviados, especifique um valor menor. |
Saída
Caractere.
Exemplos
Exemplos básicos
Retorna "Dezembro":
CMOY(`20141231`; 9)
Retorna "Dez":
CMOY(`20141231 235959`; 3)
Retorna o nome abreviado do mês para cada valor do campo Carimbo_de_data_e_hora_do_recebimento:
CMOY(Carimbo_de_data_e_hora_do_recebimento; 3)
Retorna o nome completo do mês para cada valor no campo Data_fatura:
CMOY(Data_fatura; 9)
Retorna o nome completo do mês 15 dias após cada valor no campo Data_fatura:
CMOY(Data_fatura + 15; 9)
Observações
Detalhes do parâmetro
Um campo especificado para data/datahora pode usar qualquer formato de data ou datahora, desde que a definição do campo defina corretamente o formato.
Se o parâmetro comprimento for mais curto que o nome do mês, o nome do mês será truncado no comprimento especificado. Se o parâmetro comprimento for maior do que o nome do mês, o nome do mês será preenchido com espaços em branco.
Especificação de literal de data ou de um valor datahora
Ao especificar um valor literal de data ou datahora para data/datahora, você fica restrito aos formatos na tabela abaixo e o valor deve estar entre apóstrofos invertidos – por exemplo, `20141231`.
Não use separadores como barras (/) ou dois pontos (:) entre os componentes individuais de datas ou horas.
-
Valores de datahora – você pode usar qualquer combinação de formatos de data, separador e hora listados na tabela abaixo. A data deve preceder a hora e um separador deve ser usado entre os dois. Os separadores válidos são um único espaço em branco ou as letras 't' ou 'T'.
-
Valores de tempo – as horas devem ser especificadas usando o relógio de 24 horas. Os ajustes do Tempo Universal Coordenado (UTC) devem ser precedidos por um sinal de mais (+) ou de menos (-).
Exemplos de formato
Exemplos de valores literais
AAAAMMDD
`20141231`
AAMMDD
`141231`
AAAAMMDD hhmmss
`20141231 235959`
AAMMDDthhmm
`141231t2359`
AAAAMMDDThh
`20141231T23`
AAAAMMDD hhmmss+/-hhmm
(ajuste UTC)
`20141231 235959-0500`
AAMMDD hhmm+/-hh
(ajuste UTC)
`141231 2359+01`
Nota
Não use somente hh no formato de hora principal com dados que têm um ajuste UTC. Por exemplo, evite: hh+hhmm. Os resultados podem ser não confiáveis.
Funções relacionadas
Se precisar retornar o mês do ano como número (1 a 12), use MONTH( ) em vez de CMOY( ).