Función CMOY( )

Devuelve el nombre del mes de una fecha o fechahora especificada. Abreviatura de la expresión "Mes del año en caracteres", en inglés.

Sintaxis

CMOY(fecha/fechahora; longitud)

Parámetros

Nombre Tipo Descripción
fecha/fechahora

fechahora

El campo, expresión o valor literal del cual se devuelve el nombre del mes.
longitud

numérico

Un valor entre 1 y 9 que especifica la longitud de la cadena de salida. Para mostrar los nombres abreviados de los meses, especifique un valor menor.

Salida

Carácter.

Ejemplos

Ejemplos básicos

Devuelve "Diciembre":

CMOY(`20141231`; 10)

Returns "Dic":

CMOY(`20141231 235959`; 3)

Devuelve el nombre abreviado del mes para cada valor del campo Marca_de_hora_recepción:

CMOY(Marca_de_hora_recepción; 3)

Devuelve el nombre completo del mes para cada valor del campo Fecha_de_factura:

CMOY(Fecha_de_factura ; 9)

Devuelve el nombre completo del mes 15 días después de cada valor en el campo Fecha_de_factura:

CMOY(Fecha_de_factura+15; 9)

Observaciones

Detalles del parámetro

Un campo especificado para fecha/fechahora puede utilizar cualquier formato de fecha o fechahora, siempre que la definición del campo establezca correctamente el formato.

Si el parámetro longitud es más corto que el nombre del mes, el nombre del mes se trunca según la longitud especificada. Si el parámetro longitud es más largo que el nombre del mes, el nombre del mes se rellena con espacios en blanco.

Especificar un valor de fechahora o fecha literal

Al especificar un valor literal de fecha o fechahora para fecha/fechahora, solo puede utilizar los formatos de la siguiente tabla y debe encerrar el valor entre acentos graves; por ejemplo, `20141231`.

No utilice ningún separador, como barras (/) o dos puntos (:), entre los componentes individuales de fechas u horas.

  • Valores de fechahora: puede utilizar cualquier combinación de formatos de fecha, separador y hora de la siguiente tabla. La fecha debe preceder a la hora y se debe utilizar un separador entre las dos. Los separadores válidos son un espacio en blanco, la letra 't' o la letra 'T'.

  • Valores de hora: debe especificar las horas con el reloj de 24 horas. Los desplazamientos respecto del Horario Universal Coordinado (UTC, por sus siglas en inglés) deben ir precedidos de un signo más (+) o un signo menos (-).

    Formatos de ejemplo

    Valores literales de ejemplo

    AAAAMMDD

    `20141231`

    AAMMDD

    `141231`

    AAAAMMDD hhmmss

    `20141231 235959`

    AAMMDDthhmm

    `141231t2359`

    AAAAMMDDThh

    `20141231T23`

    AAAAMMDD hhmmss+/-hhmm

    (desplazamiento de UTC)

    `20141231 235959-0500`

    AAMMDD hhmm+/-hh

    (desplazamiento de UTC)

    `141231 2359+01`

    Nota

    No use solo hh en el formato de la hora principal con datos que tienen un desplazamiento del UTC. Por ejemplo, evite: hh+hhmm. Los resultados pueden no ser confiables.

     

Funciones relacionadas

Si necesita devolver el mes del año como un número (1 al 12), utilice la función MONTH( ) en lugar de CMOY( ).

Guía de creación de scripts de ACL 14.1