public class DateSpinner
extends javax.swing.JSpinner
DateSpinner
is a spinner that is specialized in displaying or editing a a date or time.
To change the value, you can use JSpinner.setValue(Object)
and pass in a Date. To get the Date, using JSpinner.getValue()
.javax.swing.JSpinner.AccessibleJSpinner, javax.swing.JSpinner.DateEditor, javax.swing.JSpinner.DefaultEditor, javax.swing.JSpinner.ListEditor, javax.swing.JSpinner.NumberEditor
javax.swing.JComponent.AccessibleJComponent
Modifier and Type | Field and Description |
---|---|
java.text.DateFormat |
_format |
javax.swing.text.DefaultFormatter |
_formatter |
javax.swing.JSpinner.DateEditor |
_timeEditor |
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Constructor and Description |
---|
DateSpinner()
Creates a date spinner using "hh:mm:ss" as the format string.
|
DateSpinner(java.lang.String format)
Creates a date spinner using the specified format string.
|
DateSpinner(java.lang.String format,
java.util.Date date)
Creates a date spinner using the specified format string and an initial value.
|
Modifier and Type | Method and Description |
---|---|
protected javax.swing.JSpinner.DateEditor |
createDateEditor(java.lang.String format)
Creates the DateEditor.
|
protected void |
customizeSpinner()
Customizes the spinner.
|
boolean |
getAllowsInvalid()
Returns whether or not the value being edited is allowed to be invalid for a length of time.
|
boolean |
getCommitsOnValidEdit()
Returns when edits are published back to the
JFormattedTextField . |
boolean |
getOverwriteMode()
Returns the behavior when inserting characters.
|
java.util.TimeZone |
getTimeZone()
Gets the time zone.
|
boolean |
isLenient()
Tell whether date/time parsing is to be lenient.
|
void |
setAllowsInvalid(boolean allowsInvalid)
Sets whether or not the value being edited is allowed to be invalid for a length of time (that is,
stringToValue throws a ParseException ). |
void |
setCommitsOnValidEdit(boolean commit)
Sets when edits are published back to the
JFormattedTextField . |
void |
setFormat(java.lang.String format)
Sets the date format string used by this DateSpinner.
|
void |
setLenient(boolean lenient)
Specify whether or not date/time parsing is to be lenient.
|
void |
setOverwriteMode(boolean overwriteMode)
Configures the behavior when inserting characters.
|
void |
setTimeZone(java.util.TimeZone zone)
Sets the time zone for the calendar of this DateFormat object.
|
addChangeListener, commitEdit, createEditor, fireStateChanged, getAccessibleContext, getChangeListeners, getEditor, getModel, getNextValue, getPreviousValue, getUI, getUIClassID, getValue, removeChangeListener, setEditor, setModel, setUI, setValue, updateUI
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
public javax.swing.text.DefaultFormatter _formatter
public javax.swing.JSpinner.DateEditor _timeEditor
public java.text.DateFormat _format
public DateSpinner()
public DateSpinner(java.lang.String format)
format
- the format string as defined in SimpleDateFormat
.public DateSpinner(java.lang.String format, java.util.Date date)
format
- the format string as defined in SimpleDateFormat
.date
- initial valuepublic void setFormat(java.lang.String format)
format
- the formatprotected void customizeSpinner()
protected javax.swing.JSpinner.DateEditor createDateEditor(java.lang.String format)
format
- the formatpublic void setCommitsOnValidEdit(boolean commit)
JFormattedTextField
. If true, commitEdit
is
invoked after every valid edit (any time the text is edited). On the other hand, if this is false than the
DefaultFormatter
does not publish edits back to the JFormattedTextField
. As such, the
only time the value of the JFormattedTextField
will change is when commitEdit
is
invoked on JFormattedTextField
, typically when enter is pressed or focus leaves the
JFormattedTextField
.commit
- Used to indicate when edits are committed back to the JTextComponentpublic boolean getCommitsOnValidEdit()
JFormattedTextField
.public void setOverwriteMode(boolean overwriteMode)
overwriteMode
is true (the default), new
characters overwrite existing characters in the model.overwriteMode
- Indicates if overwrite or overstrike mode is usedpublic boolean getOverwriteMode()
public void setAllowsInvalid(boolean allowsInvalid)
stringToValue
throws a ParseException
). It is often convenient to allow the user to
temporarily input an invalid value.allowsInvalid
- Used to indicate if the edited value must always be validpublic boolean getAllowsInvalid()
public void setTimeZone(java.util.TimeZone zone)
zone
- the given new time zone.public java.util.TimeZone getTimeZone()
public void setLenient(boolean lenient)
lenient
- when true, parsing is lenientCalendar.setLenient(boolean)
public boolean isLenient()
DateFormat.isLenient()
.