Timezone
Standardized timezone offsets and descriptions for proper timezone conversion and display across different geographical regions.
The ref_timezone Object
Timezone collection provides standardized timezone offset information and human-readable descriptions for handling time-based data throughout the system.
| Field Name | Type | Description |
|---|---|---|
timezone_offset | string | Primary key. Timezone offset in format ±HH:MM (e.g., "+00:00", "+01:00", "-05:00"). |
timezone | string | Human-readable timezone description including major cities and standard time names. |
List Timezones
List existing timezones.
- REST
- GraphQL
GET /items/ref_timezone
query {
ref_timezone {
timezone_offset
timezone
}
}
Query Parameters
Supports all global query parameters.
Returns
An array of up to limit timezone objects. If no items are available, data will be an empty array.
Retrieve a Timezone
Retrieve a specific timezone by offset.
- REST
- GraphQL
GET /items/ref_timezone/:timezone_offset
query {
ref_timezone_by_id(id: "timezone_offset") {
timezone_offset
timezone
}
}
Returns
Returns a timezone object if a valid timezone offset was provided.
Create a Timezone
Create a new timezone.
- REST
- GraphQL
POST /items/ref_timezone
{
"timezone_offset": "+12:00",
"timezone": "+12:00 Fiji Time, New Zealand Standard Time (Auckland)"
}
mutation {
create_ref_timezone_item(data: {
timezone_offset: "+12:00"
timezone: "+12:00 Fiji Time, New Zealand Standard Time (Auckland)"
}) {
timezone_offset
timezone
}
}
Query Parameters
Supports all global query parameters.
Request Body
A partial timezone object.
Returns
Returns the timezone object for the created timezone.
Update a Timezone
Update an existing timezone.
- REST
- GraphQL
PATCH /items/ref_timezone/:timezone_offset
{
"timezone": "Updated timezone description"
}
mutation {
update_ref_timezone_item(id: "timezone_offset", data: {
timezone: "Updated timezone description"
}) {
timezone_offset
timezone
}
}
Query Parameters
Supports all global query parameters.
Request Body
A partial timezone object.
Returns
Returns the timezone object for the updated timezone.
Delete a Timezone
Delete an existing timezone.
- REST
- GraphQL
DELETE /items/ref_timezone/:timezone_offset
mutation {
delete_ref_timezone_item(id: "timezone_offset") {
timezone_offset
}
}
Returns
Empty body.
Sample Data
| Timezone Offset | Timezone Description |
|---|---|
| +00:00 | +00:00 GMT (London, Lisbon) |
| +01:00 | +01:00 Central European Time (Paris, Berlin) |
| +02:00 | +02:00 Eastern European Time (Cairo, Helsinki) |
| +03:00 | +03:00 Moscow Time, East Africa Time (Nairobi) |
| +04:00 | +04:00 Gulf Standard Time (Dubai), Samara Time |