Diese Funktion findet heraus, ob das Datum der Stichprobe in das Jahr des Datums fällt, an dem das Skript zuletzt geladen wurde, und liefert True, falls dies zutrifft, und False, falls dies nicht zutrifft.
Syntax:
YearToDate(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])
Rückgabedatentyp: Boolesch
Wird kein weiterer Parameter verwendet, ist die Zeitperiode das laufende Kalenderjahr, vom 1. Januar bis einschließlich des Tags der letzten Ausführung des Skripts.
Argumente:
| Argument | Beschreibung |
|---|---|
| timestamp | Für die Umwandlung des als Zeitstempel auszuwertenden Datums oder des Ausdrucks für die Auflösung eines Zeitstempels, z. B. '2012-10-12'. |
| yearoffset |
Durch das Festlegen von yearoffset, liefert yeartodate für denselben Zeitraum in einem anderen Jahr True. Ein negativer Wert von yearoffset verweist auf ein vorheriges Jahr, ein positiver Startwert auf ein Jahr in der Zukunft. Der aktuellste Jahresverlauf wird durch die Festlegung von yearoffset = -1 ausgewählt. Ist nichts definiert, wird 0 angenommen. |
| firstmonth |
Durch Angabe von firstmonth zwischen 1 und 12 (fehlt die Angabe, wird 1 angenommen) können Sie den Beginn des Jahres variieren. Beginnt Ihr Geschäftsjahr beispielsweise am 1. Mai, geben Sie für den Parameter firstmonth = 5 ein. |
| todaydate | Durch Angabe einer Zahl für todaydate kann das Ende der Zeitperiode festgelegt werden. Fehlt dieser Parameter, wird stattdessen der Zeitstempel der letzten Ausführung des Skripts verwendet. |
Beispiele und Ergebnisse:
Die folgenden Beispiele nehmen als letzte Ausführung des Skripts = 2011-11-18 an
| Beispiel | Ergebnis |
|---|---|
| yeartodate( '2010-11-18') | liefert False |
| yeartodate( '2011-02-01') | liefert True |
| yeartodate( '2011-11-18') | liefert True |
| yeartodate( '2011-11-19') | liefert False |
| yeartodate( '2011-11-19', 0, 1, '2011-12-31') | liefert True |
| yeartodate( '2010-11-18', -1) | liefert True |
| yeartodate( '2011-11-18', -1) | liefert False |
| yeartodate( '2011-04-30', 0, 5) | liefert False |
| yeartodate( '2011-05-01', 0, 5) | liefert True |
