Updated: July 8, 2021

Formatting Time

sap.ui.core.format.DateFormat

Intro

This article describes the international rules for time formats. The SAPUI5 time formatters will help you to comply with these rules.

Usage

Use time formatting if:

  • You need to display time based on the user’s locale settings.

Types

You can use three different  types of time formats: short, medium, and long. The formatting and order of the values differ based on the locale settings that have been configured in the browser.

Short Format

In the short format, time is displayed to the user in hours and minutes only.

United States (US): 11:15 AM

Germany (DE): 11:15

China (CN): 上午11:15

Denmark (DK):  11.15

Medium Format

If you need to display the seconds, use the medium time format.

United States (US): 11:17:57 AM

Germany (DE): 11:17:57

China (CN): 上午11:17:57

Denmark (DK): 11.17.57

Long Format

If you need to display a time zone, use the long time format.

United States (US): 11:19:27 AM GMT+01:00

Germany (DE): 11:19:27 GMT+01:00

China (CN): GMT+01:00 上午11:19:27

Denmark (DK): 11.19.27 GMT+01:00

Guidelines

  • In general, use the short format.
  • Use the correct time format according to your language or locale settings.
    If you have to display a time format as an object attribute, follow the formatting rules for the object header and object list item attribute.

Durations

If you need to display durations, show every number and unit of measurement according to the rules for units of measurement. (For example, use long text instead of ISO codes or abbreviations.)

Do
Use long text to display durations
Use long text to display durations
Don't
Do not use abbreviations when durations have to be displayed
Do not use abbreviations when durations have to be displayed

Time Intervals

If you need to display time intervals, use “–” as a delimiter between the times.

United States (US): 11:29 AM – 2:29 PM

Germany (DE): 11:29 – 14:29

China (CN): 上午11:29 – 下午2:29

Denmark (DK): 11.29 – 14.29

Resources

Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

Elements and Controls

Implementation