Class Calendar

java.lang.Object

java.util.Calendar

java.util.GregorianCalendar

vaadinx.util.Calendar

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Calendar>

Direct Known Subclasses:

GregorianCalendar

@Deprecated
public abstract class Calendar
extends GregorianCalendar

Deprecated.

Transitional scaffolding produced by the import-swap. It keeps migrated Calendar code running with the right zone; hand-written and stage-3 code should use java.time (e.g. LocalDate/ZonedDateTime with com.vaadin.swingbridge.surrogates.BrowserTimeZone.get()) or com.vaadin.swingbridge.surrogates.SHelper, which are immutable and ZoneId-consistent.

Import-swap emulator for Calendar (java.util.Calendar → vaadinx.util.Calendar). Hosts the getInstance(...) factories; the concrete work is done by GregorianCalendar, which getInstance returns (matching the JDK, where Calendar.getInstance() hands back a GregorianCalendar in the common locales).

Why this exists. On the desktop one JVM serves one user, so Calendar.getInstance() / new GregorianCalendar(...) pick up TimeZone.getDefault() — which is the user's zone. On the server the default is the server's zone, so a migrated cal.set(y, m, d); cal.getTime() silently computes the wrong instant (server midnight, not the user's). This emulator defaults construction to the user's browser zone instead, via EmulatorContext.currentTimeZone() — reusing the same resolution the SimpleDateFormat emulator uses: browser zone on a UI thread (throwing SD_browser_timezone if BrowserTimeZone.fetch() was never called), the propagated zone on a background thread carrying an EmulatorContext, or the server default (with a WARN) on a bare background thread. An explicitly supplied TimeZone always wins.

Not a facade — a thin zone-defaulting subclass. Unlike the SimpleDateFormat emulator (which routes through a hidden per-session backing), this holds no extra state and overrides no behavior beyond the construction-time zone: every get/set/add/roll is inherited GregorianCalendar field math, unchanged. The returned object is a plain, thread-confined Calendar.

It does NOT make a shared Calendar thread-safe. A Calendar stashed in a static/shared field and mutated from multiple threads is unsound on a multi-user server — as it already was racy on the desktop, only masked by single-threaded EDT use. The migration answer for that shape is to unshare it (construct one per use); it is flagged for manual fixing, not silently emulated. This emulator targets the dominant one-off idiom.

The zone is applied via TimeZone.getTimeZone(java.time.ZoneId) — the same arithmetic the DatePicker-backed surrogates convert with, so a date built here shows its own day in a picker in every year, pre-1900 included.

Emulator-only — no surrogate; not a Component (D_timer_swingworker sibling of SimpleDateFormat / SwingWorker).

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class Calendar

Calendar.Builder

Field Summary

Fields inherited from class GregorianCalendar

AD, BC

Fields inherited from class Calendar

ALL_STYLES, AM, AM_PM, APRIL, areFieldsSet, AUGUST, DATE, DAY_OF_MONTH, DAY_OF_WEEK, DAY_OF_WEEK_IN_MONTH, DAY_OF_YEAR, DECEMBER, DST_OFFSET, ERA, FEBRUARY, FIELD_COUNT, fields, FRIDAY, HOUR, HOUR_OF_DAY, isSet, isTimeSet, JANUARY, JULY, JUNE, LONG, LONG_FORMAT, LONG_STANDALONE, MARCH, MAY, MILLISECOND, MINUTE, MONDAY, MONTH, NARROW_FORMAT, NARROW_STANDALONE, NOVEMBER, OCTOBER, PM, SATURDAY, SECOND, SEPTEMBER, SHORT, SHORT_FORMAT, SHORT_STANDALONE, SUNDAY, THURSDAY, time, TUESDAY, UNDECIMBER, WEDNESDAY, WEEK_OF_MONTH, WEEK_OF_YEAR, YEAR, ZONE_OFFSET

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Calendar()	Deprecated.
protected	Calendar(Locale aLocale)	Deprecated.
protected	Calendar(TimeZone zone)	Deprecated.
protected	Calendar(TimeZone zone, Locale aLocale)	Deprecated.

Method Summary

Modifier and Type	Method	Description
static Calendar	getInstance()	Deprecated.
static Calendar	getInstance(Locale aLocale)	Deprecated.
static Calendar	getInstance(TimeZone zone)	Deprecated.
static Calendar	getInstance(TimeZone zone, Locale aLocale)	Deprecated.

Methods inherited from class GregorianCalendar

add, clone, computeFields, computeTime, equals, from, getActualMaximum, getActualMinimum, getCalendarType, getGreatestMinimum, getGregorianChange, getLeastMaximum, getMaximum, getMinimum, getTimeZone, getWeeksInWeekYear, getWeekYear, hashCode, isLeapYear, isWeekDateSupported, roll, roll, setGregorianChange, setTimeZone, setWeekDate, toZonedDateTime

Methods inherited from class Calendar

after, before, clear, clear, compareTo, complete, get, getAvailableCalendarTypes, getAvailableLocales, getDisplayName, getDisplayNames, getFirstDayOfWeek, getMinimalDaysInFirstWeek, getTime, getTimeInMillis, internalGet, isLenient, isSet, set, set, set, set, setFirstDayOfWeek, setLenient, setMinimalDaysInFirstWeek, setTime, setTimeInMillis, toInstant, toString

Methods inherited from class Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

Calendar

protected Calendar()

Deprecated.

Calendar

protected Calendar(TimeZone zone)

Deprecated.

Calendar

protected Calendar(Locale aLocale)

Deprecated.

Calendar

protected Calendar(TimeZone zone,
 Locale aLocale)

Deprecated.

Method Details

getInstance

public static Calendar getInstance()

Deprecated.

getInstance

public static Calendar getInstance(TimeZone zone)

Deprecated.

getInstance

public static Calendar getInstance(Locale aLocale)

Deprecated.

getInstance

public static Calendar getInstance(TimeZone zone,
 Locale aLocale)

Deprecated.