Timepicker"

From Documentation
Line 106: Line 106:
 
| <center>default</center>
 
| <center>default</center>
 
|[[Image:timebox_mold_default.png ]]
 
|[[Image:timebox_mold_default.png ]]
|-
 
| <center>rounded</center>
 
|[[Image:timebox_mold_rounded.png ]]
 
[Since 5.0.0]
 
 
|}
 
|}
  

Revision as of 08:46, 13 May 2015

Timepicker

Employment/Purpose

A selection box for holding a time (a java.util.Date Object) , but only Hour, Minute, and Second are used.

Example

ZKCompRef Timebox.png


 <window title="Simple" width="300px" border="normal">
     <timebox id="tb0"/>
 </window>


Properties

Format

Use a to signify it is am or pm. The input string follows the formatting of the SimpleDateFormat.

Below is an example of using a within the format.

<zk>
	<window title="Test">
		<timepicker format="a hh:mm:ss"/>
	</window>
</zk>

In addition to specifying the format explicitly, you could specify the styling[1]. There are two different types of styling: short, medium (representing the styling of java.text.DateFormat). For example, you could specify the styling rather than the real format as follows.

<timepicker format="short"/>
<timepicker format="medium"/>

Then the real format of the timepicker will be decided at run time depending the configuration. For more information, please refer to ZK Developer's Reference: Date and Time Formatting.


  1. The styling is available since 5.0.7

min

By default, the options of timepicker start at 0:00 AM, you could specify another minimum time by using a java.util.Date Object.

<zscript>
	import java.util.Date;
	Date min = new Date();
	min.setTime(0);
</zscript>
<timepicker format="HH:mm a" min="${min}" />

max

By default, the options of timepicker end before 12:00 AM, you could specify another maximum time by using a java.util.Date Object.

<zscript>
	import java.util.Date;
	Date max = new Date();
	max.setTime(0);
</zscript>
<timepicker format="HH:mm a" max="${max}" />

interval

By default, the interval of the options in timepicker is one hour, you could specify the interval by using an integer (unit: 1 second).

<timepicker format="HH:mm a" interval="600" />

Inherited Functions

Please refer to FormatInputElement for inherited functions.

Supported Events

Name
Event Type
None None

Supported Molds

Available molds of a component are defined in lang.xml embedded in zul.jar.

Name
Snapshot
default
Timebox mold default.png

Supported Children

*NONE

Use Cases

Version Description Example Location
     

Version History

Last Update : 2015/05/13


Version Date Content
     


Last Update : 2015/05/13

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.