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

alignInterval()

Die best gerundete Zeitangabe aus einem Intervall berechnen.

Syntax:

int64 alignInterval ( min_interval, max_interval )

Parameter:

min_interval Skalar, Liste oder Map mit den Inklusiv-Untergrenzen.
max_interval 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_interval und max_interval wird der beste gerundete Zeitabgabe aus dem Intervall [min_interval .. max_interval] berechnet. Bevorzugt werden Zeitangaben von ganzen Wochen vor Tagen vor Stunden vor Minuten vor Sekunken.

Bei den Stunden werden die Vielfachen der folgenden Werte bevorzugt verwendet (absteigende Priorität): 12,6,3,2
Bei den Minuen und Sekunden sind es die Werte: 30,15,10,5,2

Siehe auch:
 alignTime()   alignDate()   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.