Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans la partie de l'année comprenant l'argument base_date jusqu'à la dernière milliseconde spécifiée dans base_date.
InYearToDate (timestamp, base_date, period_no[, first_month_of_year])
Type de données renvoyé : booléen
| Argument | Description |
|---|---|
| timestamp | Date à comparer à base_date. |
| base_date | Date utilisée pour évaluer l'année. |
| period_no | Il est possible de décaler l'année à l'aide de l'argument period_no. period_no est un entier, où la valeur 0 indique l'année comprenant l'argument base_date. Les valeurs négatives de l'argument period_no indiquent les années passés tandis que les valeurs positives désignent les années à venir. |
| first_month_of_year | Si vous voulez utiliser des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year. |
inyeartodate ('2013/01/25', '2013/02/01', 0)
Renvoie True.
inyeartodate ('2012/01/25', '2013/01/01', 0)
Renvoie False.
inyeartodate ('2012/01/25', '2013/02/01', -1)
Renvoie True.
inyeartodate ('2012/11/25', '2013/01/31', 0, 4)
Renvoie True.
La valeur de timestamp tombe pendant l'exercice fiscal débutant au quatrième mois et avant la valeur définie par base_date.
inyeartodate ( '2013/3/31', '2013/01/31', 0, 4 )
Renvoie False.
Par comparaison avec l'exemple précédent, la valeur de timestamp est toujours comprise dans l'exercice fiscal, mais elle se trouve après la valeur de base_date. Elle tombe donc en dehors de la partie de l'année spécifiée.
Ajoutez l'exemple de script à votre document et exécutez-le. Ensuite, ajoutez au moins les champs répertoriés dans la colonne des résultats à une feuille de votre document afin de visualiser le résultat.
Cet exemple permet de vérifier si une date de facture tombe pendant un exercice fiscal spécifié au moyen de la valeur first_month_of_year définie sur 4 et dans la partie de l'année précédant la fin du 31/01/2013.
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 *,
InYearToDate(InvDate, '31/01/2013', 0, 4) AS FinYr2Date
Resident TempTable;
Drop table TempTable;
La table résultante présente les dates initiales et une colonne contenant la valeur de retour de la fonction inyeartodate().
| InvDate | FinYr2Date |
|---|---|
| 28/03/2012 | 0 (False) |
| 10/12/2012 | -1 (True) |
| 5/2/2013 | 0 (False) |
| 31/3/2013 | 0 (False) |
| 19/5/2013 | 0 (False) |
| 15/9/2013 | 0 (False) |
| 11/12/2013 | 0 (False) |
| 2/3/2014 | 0 (False) |
| 14/5/2014 | 0 (False) |
| 13/6/2014 | 0 (False) |
| 7/7/2014 | 0 (False) |
| 4/8/2014 | 0 (False) |
