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.