Tools/timezone/current_time

timezone/current_time

The current date and time in a given IANA time zone, with UTC offset and DST state.

Free / no pricing configured

What it does

Returns the current wall-clock date and time in a time zone, along with its UTC offset, whether daylight saving is currently in effect, the zone abbreviation, the equivalent UTC time, and a Unix timestamp.

Primary use cases

  • Answering "what time is it in <place>" once the place is mapped to its IANA zone.
  • Stamping events or scheduling decisions in a user's local time.
  • Checking whether a zone is currently observing daylight saving.

Good to know

The timezone argument is an IANA name (e.g. Asia/Makassar, Europe/London, America/New_York), not a city or country. If you only know the place, supply its IANA zone from general knowledge, or use list_timezones to find it. Computed locally from current time-zone data, so the offset and DST state are accurate across daylight-saving boundaries.

Parameters

timezonestringrequired

IANA time-zone name (e.g. Asia/Makassar, Europe/London, America/New_York).

timezone/current_time — Faro