# monthstart - función de script y de gráfico

Esta función devuelve un valor correspondiente a una indicación de fecha y hora con el primer milisegundo del primer día del mes que contiene la fecha date. El formato de salida por defecto será el DateFormat definido en el script.

Sintaxis:

MonthStart(date[, period\_no])

**Tipo de datos que devuelve:** dual

Argumentos:

Argumentos de MonthStart

| Argumento | Descripción |
| --- | --- |
| date | La fecha que se ha de evaluar. |
| period\_no | period\_no es un entero, el cual, si es 0 o se omite, indica el mes que contiene la fecha date. Los valores negativos en period\_no indican meses precedentes y los valores positivos indican meses posteriores. |

Ejemplos y resultados:

Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la sentencia SET DateFormat en la parte superior de su script de carga. Cambie el formato en los ejemplos según se ajuste a sus necesidades.

Ejemplo 1:

`monthstart('19/10/2001')`

Devuelve 01/10/2001.

Ejemplo 2:

`monthstart('19/10/2001', -1)`

Devuelve 01/09/2001.

Ejemplo 3:

Añada el script de ejemplo a su documento y ejecútelo. A continuación, añada como mínimo los campos de la columna de resultados a una hoja de su documento para ver el resultado.

Este ejemplo encuentra el primer día del mes de cada fecha de facturación de la tabla, donde base\_date se desplaza cuatro meses especificando period\_no como 4.

`TempTable:` `LOAD RecNo() as InvID, * Inline [` `InvDate` `28/03/2012` `10/12/2012` `5/2/2013` `31/3/2013` `19/5/2013` `15/9/2013` `11/12/2013` `2/3/2014` `14/5/2014` `13/6/2014` `7/7/2014` `4/8/2014` `];` ` ` `InvoiceData:` `LOAD *,` `MonthStart(InvDate, 4) AS MthStart` `Resident TempTable;`

`Drop table TempTable;`

La tabla resultante contiene las fechas originales y una columna con el valor de retorno de la función monthstart(). Podemos mostrar la fecha hora completa especificando el formato en las propiedades de gráfico.

Resultados del ejemplo 3

| InvDate | MthStart |
| --- | --- |
| 28/03/2012 | 01/07/2012 |
| 10/12/2012 | 01/04/2013 |
| 5/2/2013 | 01/06/2013 |
| 31/3/2013 | 01/07/2013 |
| 19/5/2013 | 01/09/2013 |
| 15/9/2013 | 01/01/2014 |
| 11/12/2013 | 01/04/2014 |
| 2/3/2014 | 01/07/2014 |
| 14/5/2014 | 01/09/2014 |
| 13/6/2014 | 01/10/2014 |
| 7/7/2014 | 01/11/2014 |
| 4/8/2014 | 01/12/2014 |