Date and Time

​

Best Practices

Explore best practices for displaying date and time across ServiceTitan.

​

Use standard formats

Use standard, easily recognizable formats for dates and times.

• Date (US): Use MM/DD/YYYY format.
• Time: Use 12-hour format with am/pm (e.g., “03:00 pm”)

Use full month names when clarity is critical or ambiguity is likely (e.g., in global contexts).

• Example: The appointment is on July 12, 2025, at 3:00 pm PST.

Use MM/DD/YYYY or clear full month names. Avoid informal or inconsistent formats that may confuse users.

​

Global Audiences

Consider using the 24-hour format for a global audience to avoid ambiguity. Default to UTC when:

• The user’s time zone isn’t known.
• The action is system-level (logs, audit trails, global reporting).
• The user is part of a distributed or international team.

Use tenant time zone when:

• The user expects the time to be “local” (e.g., scheduling, invoicing, time tracking).
• The UI can clearly communicate the time zone (e.g., “PST,” “CST,” or “Tenant Time Zone: Pacific Time”).

Consider using the 24-hour format for a global audience to avoid ambiguity. Avoid mixing 12-hour and 24-hour formats incorrectly.

​

Include Time Zones

Specify time zones when times are relevant to users in different regions. Avoid omitting time zones when the time is relevant to a geographically diverse audience.

​

Be Consistent

Be consistent with formats throughout your content to avoid confusion. Avoid switching between different date and time formats within the same content.

​

Leading Zeros

When UTC format is used, all four digits should be used. When specifying a time zone, the leading zero is not required when the hour is not a double digit. Use leading zeros for single-digit times for clarity.

​

Relative Time References

Use relative time references where appropriate for user convenience. Avoid vague or unclear time references.

​

Avoid Ambiguity

Use full month names to avoid ambiguity. Avoid using abbreviated month names if they can be misinterpreted. The exception is in Toolbar Filters, where additional context is provided by the date icon and the surrounding component.

​

Date Ranges

Use en-dashes for date ranges and ensure clarity. Avoid mixing 12-hour and 24-hour formats incorrectly.