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

Esta función devuelve una indicación de fecha y hora correspondiente al inicio del primer día del año que contiene a la fecha date. El formato de salida por defecto será el DateFormat definido en el script.

Sintaxis:

YearStart(date[, period\_no[, first\_month\_of\_year]])

**Tipo de datos que devuelve:** dual

Argumentos:

Argumentos de YearStart

| Argumento | Descripción |
| --- | --- |
| date | La fecha que se ha de evaluar. |
| period\_no | period\_no es un entero, en el que el valor 0 indica el año que contiene a date. Los valores negativos de period\_no indican años precedentes y los valores positivos indican años futuros. |
| first\_month\_of\_year | Si desea trabajar con años (fiscales) que no comiencen en enero, especifique un valor entre 2 y 12 en first\_month\_of\_year. |

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:

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

Devuelve 01/01/2001.

Ejemplo 2:

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

Devuelve 01/01/2000.

Ejemplo 3:

`yearstart ('19/10/2001', 0, 4)`

Devuelve 01/04/2001.

Ejemplo 4:

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 año de cada fecha de facturación de la tabla, donde el primer mes del año se especifica como mes 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 *,` `YearStart(InvDate,  0, 4) AS YrStart` `Resident TempTable;`

`Drop table TempTable;`

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

Resultados del ejemplo 4

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