Styles

Use the Duration format to format the display of numerical data as a duration of time, such as 4 Days and 17 Hours.

The Convert From takes numerical input and formats it according to what you specify. Convert From options include:

• Milliseconds
• Seconds
• Minutes
• Hours

The available duration Formats include:

• Time Span (00:00:00)
• Friendly Short Units (h, m, s)
• Friendly Medium Units (Hrs, Mins, Secs)
• Friendly Long Units (Hours, Minutes, Seconds)

The following controls support the duration format:

• Data Label
• Label
• Text Box
• Text Area

Configuring the Control with Duration Format

The following is an example of how to use the Duration format on a control.

1. On a view, add a text box control.
2. Select the control and click the Styles ellipses (...) in the control properties.
   
3. On the Style Builder page, select the Duration option on the Format tab. Choose a Convert From and Format option.
   
4. Click OK, then Save and Finish the view.
5. Run the view.
6. Enter a numerical value in the text box.
   
7. The numerical value changes to the specified Duration format.
   

Considerations

• You can only format whole numbers.
• If you enter a value in runtime that is not a number, the value is ignored.
• The list of Duration formats depends on the browser culture (User Settings) or the custom selected culture (User option) you configure as the Language/Region.

Use the Special format to format numbers as shown in the image below.

Four default special formats are available for the English (United States) culture:

• Phone Number
• Social Security Number
• Zip code
• Zip code + 4

Examples

The following examples indicate how the patterns apply to the text entered in runtime:

Text entered	Pattern	Result
Phone Number
1234567890	(###) ###-####	(123) 456-7890
Social Security Number
123456789	###-##-####	123-45-6789
Zip code
12345	#####	12345
Zip code + 4
123456789	#####-####	12345-6789

Creating Custom Special Formats

You can also create a custom special format. See the following link in the K2 Developer Reference for more detail:Adding and Using a Custom Special Format in the Style Builder

Considerations

The following principles apply when you use special formatting:

• Formatting applies to numbers that you enter into the control in runtime.
• If you enter a value in runtime that is not a number, the value is ignored.
• A “#” in the pattern is replaced with the number corresponding to the position in the text that you enter.
• Replacement is done from the back to the front of the text that you enter in runtime.
• Any other symbol/character in the pattern is used, for example -, (, ) See examples above in the Special Formatting section.
• A 0 (zero) in the pattern represents either the number corresponding to the position in the text that you enter, or if a number does not exist for it a 0 is used.
• The list of Special formats depends on the browser culture (User Settings) or the custom selected culture (User option) you configure as the Language/Region setting.
• The pattern applies to the display at runtime, the underlying value remains the same as what you enter.