withAmPmAdded

Syntax

	$calendar.withAmPmAdded($value)

Beschreibung

Erstellt einen neuen Kalender aus dem gegebenen Kalender, wobei die Tageszeit um value erhöht wird. Die Addition des Wertes kann Auswirkungen auf andere Werte haben, zum Beispiel auf die Stunde.

Parameter

Name Typ Beschreibung Pflicht Default
calendar Fachobjekt Der Kalender, dessen Tageszeit geändert werden soll. Es kann sich dabei um einen System- oder Benutzerkalender handeln. ja
value Zahl Wert um den amPm erhöht werden soll. ja

Rückgabewert

Typ: Fachobjekt

Ein Kalender mit dem geänderten Wert für die Tageszeit.

Beispiele

	dateTime(2012, 8, 10, 19, 55, 24, 13).toUserCalendar().withAmPmAdded(1).amPm()

Ausgabe: 0

Da es sich bei 19 Stunden um den Nachmittag handelt, ist amPm ursprünglich 1 (also p.m.).

Stunde nach Anpassung

	dateTime(2012, 8, 10, 19, 55, 24, 13).toUserCalendar().withAmPmAdded(1).hour()

Ausgabe: 7

Die Anpassung von amPm ändert auch andere Werte wie die Stunde.