Syntax

	$calendar.withEraAdded($value)

Beschreibung

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

Falls die die neue Zahl der Epoche die Gesamtzahl der möglichen Epochen übersteigt (im Falle von GregorianCalendar gibt es 2 Epochen: BC und AD), dann wird die Epoche auf den höchsten Wert gesetzt. Es wird nicht wie zum Beispiel in withDayAdded mit der Zählung von vorne angefangen.

Parameter

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

Rückgabewert

Typ: Fachobjekt

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

Beispiele

	dateTime(2012, 8, 14, 7, 55, 24, 13).toUserCalendar().withEraAdded(1).era()

Ausgabe: 1

Die Epoche des Datums entspricht bereits 1 und kann keinen höheren Wert annehmen, da es im gregorischen Kalender nur 2 Epochen gibt. Daher bleibt die Epoche unverändert.