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:
| 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.
| 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 |
