API Timing

All timing fields in T-Gate API uses UTC, which means that any time attribute returning from our APIs is related to the UTC Timing. However, there are different timing formats that you need to consider.

Time Formats

T-Gate uses a set of time formats that we find useful in its situation.

🕑
API Endpoint Time Format
Regarding timing attributes, the time format used by each attribute will be mentioned in the API endpoint details.

UNIX Timestamp

The UNIX timestamp, also known as POSIX time or Epoch time, is a system for tracking time. It represents the number of seconds that have elapsed since the Unix Epoch, which is 00:00:00 UTC on 1 January 1970, not counting leap seconds. It's a standard time representation used in many operating systems and file formats.

Example

The Unix timestamp 1697540684 represents the date and time: 2023-10-17 11:04:44

ISO 8601 Format

The ISO 8601 is an international standard for representing dates and times. The format is designed to eliminate the ambiguity in date and time representation and to facilitate communication across different systems and time zones. Here are the key components and formats specified by ISO 8601

Example

Date and time with a time zone offset: 2023-02-06T12:38:03.081+03:00

This time format can be broken down into:

Date and time in UTC: 2023-02-06T09:38:03.081Z (Converted from +03:00 to UTC)
Date and time with a time zone offset: 2023-02-06T12:38:03.081+03:00
Date only: 2023-02-06
Time only: 12:38:03.081

24-hour Clock System

The 24-hour clock system, also known as military time or the international standard time, is a way of telling time based on a 24-hour scale rather than the 12-hour scale

Hours: The day is divided into 24 hours, starting from midnight (00:00) and going until the next midnight. Each hour is represented by two digits ranging from 00 to 23.
Minutes: Minutes are counted as usual, ranging from 00 to 59.

Example

In the 24-hour clock system, 14:00 represents 2:00 PM.

YYYY-MM-DD Format

Example

2023-02-06 represents February 6, 2023.