Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Current »

Some methods return detailed time zone related information. For example, see Person settings

PROPERTIES

The time zone properties are a JSON object with these properties:

id

A unique ID of the time zone. When updating time zones you would use this identifier.

Example: Romance Standard Time

string

name

A print name of the time zone inclusive a time zone offset. Note that the offset is for regular time but not daylight saving time.

Example: (UTC+01:00) Brussels, Copenhagen, Madrid, Paris

You should not show this name to users. It is confusing since invalid during daylight saving time.

string

currentName

The print name of the time zone and adjusted to whether we are in daylight saving time or not.

Example: Romance Daylight Time

You should show this name to users, together with the current offset.

string

currentOffset

The today’s time zone offset with hours, minutes and seconds. Example: 02:00:00

The offset changes when currently in daylight saving time.

string

currentDate

Today’s date and time as perceived from the UTC time zone. So it basically tells someone living in UTC what the time is of the user. This is simply the current UTC time plus the time zone offset.

datetime

supportsDaylightSaving

If true then the selected time zone has a daylight saving period.

bool

EXAMPLE

A typical time zone information:

{
	"id": "Romance Standard Time",
	"name": "(UTC+01:00) Brussels, Copenhagen, Madrid, Paris",
	"currentName": "Romance Daylight Time",
	"currentDate": "2022-05-11T17:28:12.4421194+00:00",
	"currentOffset": "02:00:00",
	"supportsDaylightSaving": true
}

  • No labels