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

Esta función encuentra si la fecha de entrada cae en el año de la fecha en la que se cargó el script, y devuelve True en caso afirmativo, y False en caso negativo.

Sintaxis:

YearToDate(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])

**Tipo de datos que devuelve:** Booleano

Si no se utiliza ninguno de los parámetros opcionales, el año hasta la fecha implica cualquier fecha dentro de un año natural, desde el 1 de enero hasta e incluido el día de la última ejecución del script.

Argumentos:

Argumentos de YearToDate

| Argumento | Descripción |
| --- | --- |
| timestamp | La fecha que se ha de evaluar como una indicación de tiempo o una expresión que devuelve una fecha, para convertir, por ejemplo '2012-10-12'. |
| yearoffset | Al especificar un yearoffset, yeartodate devuelve True para el mismo periodo de otro año. Un yearoffset negativo indica un año anterior, y uno positivo un año futuro. El año hasta la fecha más reciente se obtiene especificando yearoffset = -1. Si se omite, se presupone 0. |
| firstmonth | Especificando un firstmonth de entre 1 y 12 (1 si se omite) el comienzo del año puede moverse hacia delante, al primer día de cualquier mes. Si por ejemplo, si desea trabajar con un año fiscal que comience el 1 de mayo, especifique firstmonth = 5. |
| todaydate | Especificando una todaydate (o fecha/hora de la última ejecución de script, en caso de omitirse) podemos desplazar el día utilizado como límite superior del período. |

Ejemplos y resultados:

Los ejemplos a continuación asumen como el último momento de recarga = 2011-11-18

Ejemplos y resultados

| Ejemplo | Resultado |
| --- | --- |
| `yeartodate( '2010-11-18')` | devuelve False |
| `yeartodate( '2011-02-01')` | devuelve True |
| `yeartodate( '2011-11-18')` | devuelve True |
| `yeartodate( '2011-11-19')` | devuelve False |
| `yeartodate( '2011-11-19', 0, 1, '2011-12-31')` | devuelve True |
| `yeartodate( '2010-11-18', -1)` | devuelve True |
| `yeartodate( '2011-11-18', -1)` | devuelve False |
| `yeartodate( '2011-04-30', 0, 5)` | devuelve False |
| `yeartodate( '2011-05-01', 0, 5)` | devuelve True |