Cette fonction permet de déterminer si la date d'entrée tombe dans l'année de la date à laquelle le script a été chargé pour la dernière fois et renvoie True si c'est le cas ou False si ce n'est pas le cas.
YearToDate(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])
Type de données renvoyé : booléen
Si aucun des paramètres facultatifs n'est utilisé, l'année en cours correspond à toute date comprise dans une année calendaire, qui s'étend du 1er janvier à la date de la dernière exécution du script comprise.
| Argument | Description |
|---|---|
| timestamp | Date à évaluer en tant qu'horodatage ou expression aboutissant à un horodatage, à convertir, par exemple '2012-10-12'. |
| yearoffset |
En spécifiant une valeur pour yearoffset, yeartodate renvoie True pour la même période d'une autre année. Un décalage yearoffset négatif indique une année antérieure tandis qu'un décalage positif indique une année ultérieure. La valeur year-to-date la plus récente est obtenue en spécifiant yearoffset = -1. Si cette valeur est omise, 0 est défini par défaut. |
| firstmonth |
Si vous spécifiez un argument firstmonth compris entre 1 et 12 (1 si l'argument est omis), il se peut que le début de l'année soit avancé au premier jour de n'importe quel mois. Par exemple, si vous voulez travailler sur un exercice fiscal débutant le premier mai, spécifiez firstmonth = 5. |
| todaydate | Vous pouvez déplacer le jour utilisé comme limite supérieure de la période en indiquant une date todaydate (horodatage de la dernière exécution du script si l'argument est omis). |
Dans les exemples suivants, nous supposons que l'heure du dernier rechargement est égale à 2011-11-18.
| Exemple | Résultat |
|---|---|
| yeartodate( '2010-11-18') | renvoie False |
| yeartodate( '2011-02-01') | renvoie True |
| yeartodate( '2011-11-18') | renvoie True |
| yeartodate( '2011-11-19') | renvoie False |
| yeartodate( '2011-11-19', 0, 1, '2011-12-31') | renvoie True |
| yeartodate( '2010-11-18', -1) | renvoie True |
| yeartodate( '2011-11-18', -1) | renvoie False |
| yeartodate( '2011-04-30', 0, 5) | renvoie False |
| yeartodate( '2011-05-01', 0, 5) | renvoie True |
