prevnext   » Startseite » Haupt-Referenz » Funktions-Referenz » alignDate()

alignDate()

Das best gerundete Datum aus einem Intervall berechnen.

Syntax:

int32 alignDate ( min_time, max_time )

Parameter:

min_time Skalar, Liste oder Map mit den Inklusiv-Untergrenzen.
max_time Skalar, Liste oder Map mit den Inklusiv-Obergrenzen.

Beschreibung:

Sind beide Parameter skalar, dann wird aus beiden Werten mitels time() eine Zeit berechnet. Anschließend werden beide Werte direkt verknüpft. Das Ergebnis ist ebenfalls numerisch.

Ist eines der beiden Parameter skalar und der andere eine Liste oder Map, dann wird der skalare Wert mit jedem Element der Liste bzw. Map, auch rekursiv, verknüpft. Das Funktionsergebnis ist dann eine Liste bzw. Map.

Sind beide Parameter eine Liste, dann werden die einzelnen Elemente verknüpft. Hieraus ergibt sich automatisch die Rekursion. Die Anzahl der Elemente in der Ergebnisliste entspricht die der kleineren Liste, d.h. die überzähligen Elemente der längeren Liste werden ignoriert. Das Funktionsergebnis ist dann eine Liste.

Sind beide Parameter eine Map, dann werden die einzelnen Elemente mit dem selben Schlüssel verknüpft. Hieraus ergibt sich automatisch die Rekursion. Elemente, die sich nur in einer Map befinden, werden ignoriert. Das Funktionsergebnis ist dann eine Map.

In allen anderen Fällen werden keine Berechnungen durchgeführt und das Funktionsergebnis ist NONE.

Die skalare Berechnung:

Für jedes Skalar-Paar aus min_time und max_time wird das best gerundete Datum aus dem Intervall [min_time .. max_time] berechnet. Bevorzugt werden Daten an Jahres- vor Monatsgrenzen.

Bei den Monaten (Monatsnummer-1) werden die Vielfachen der folgenden Werte bevorzugt verwendet (absteigende Priorität): 6,3,2.
Bei den Tagen (Tagesnummer-1) sind es die Werte: 15,8,4,2.

Siehe auch:
 alignTime()   alignInterval()   alignNumber() 

Weitere ähnliche Funktionen:

Ideale Zahl
Funktion Kurzinfo
alignDate() Das best gerundete Datum aus einem Intervall berechnen.
alignInterval() Die best gerundete Zeitangabe aus einem Intervall berechnen.
alignNumber() Die best gerundete Nummer aus einem Intervall berechnen.
alignTime() Den best gerundeten Zeitpunkt aus einem Intervall berechnen.