Timezone

Represents an IANA timezone with identifier, UTC offset, and DST information. Enables consistent time handling across scheduling, calendars, and internationalized displays.

6 properties

Schema

Properties

Property	Type	Mode	Description	Required
identifier	string	stored	IANA timezone database identifier (e.g., 'America/New_York', 'Europe/Paris', 'UTC') Example: `"America/New_York"`	Required
displayName	string	stored	Human-readable display name for the timezone Example: `"Eastern Time (US & Canada)"`	Required
utcOffset	string	stored	Current UTC offset in ±HH:MM format (may change with DST) Example: `"-05:00"`	Optional
region	string	stored	Geographic region or continent Values: `africa, america, antarctica, asia, atlantic, australia, europe, indian, pacific, utc` Example: `"america"`	Optional
country	Country	stored	Primary country associated with this timezone (if applicable)	Optional
supportsDST	boolean	stored	Whether this timezone observes Daylight Saving Time Example: `true`	Optional

Examples

Example 1

{
  "@type": "Timezone",
  "identifier": "America/New_York",
  "displayName": "Eastern Time (US & Canada)",
  "utcOffset": "-05:00",
  "region": "america",
  "country": {
    "@type": "Country",
    "code": "US",
    "name": "United States"
  },
  "supportsDST": true
}

Example 2

{
  "@type": "Timezone",
  "identifier": "Europe/Paris",
  "displayName": "Central European Time",
  "utcOffset": "+01:00",
  "region": "europe",
  "country": {
    "@type": "Country",
    "code": "FR",
    "name": "France"
  },
  "supportsDST": true
}

Example 3

{
  "@type": "Timezone",
  "identifier": "Asia/Tokyo",
  "displayName": "Japan Standard Time",
  "utcOffset": "+09:00",
  "region": "asia",
  "country": {
    "@type": "Country",
    "code": "JP",
    "name": "Japan"
  },
  "supportsDST": false
}

Example 4

{
  "@type": "Timezone",
  "identifier": "UTC",
  "displayName": "Coordinated Universal Time",
  "utcOffset": "+00:00",
  "region": "utc",
  "supportsDST": false
}