$calendar.withAmPmAdded($value)
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.
| 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 |
Typ: Fachobjekt
Ein Kalender mit dem geänderten Wert für die Tageszeit.
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.).
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.