Skip to content
    TimeLogic API logoTimeLogic API
    Sign in
    Endpoint guide

    DST status

    GET /v1/time/dstOpenAPI YAML

    Whether a zone is currently observing daylight saving time, plus the resolved local time.

    What do I need to send?

    Required / choose this first

    A target selector is optional; omit it for UTC or choose one of tz, ip, lat + lon, or offset.

    Optional

    next includes the next transition when available. format and sign are optional.

    Rule: Fixed offsets always return dst_active=false because they have no DST rules.

    NameNeeded?Use it for
    tzChoose one targetIANA timezone.
    ipChoose one targetIPv4 or IPv6 address.
    latPair parameterLatitude, pair with lon.
    lonPair parameterLongitude.
    offsetChoose one targetFixed UTC offset (URL-encode + as %2B). Always returns dst_active=false.
    formatOptionalstrftime pattern for an additional `formatted` field, e.g. %Y-%m-%d %H:%M:%S.
    nextOptionalSet true to include the next DST transition when available.
    signOptionalSet true for a signed response.

    Code samples

    Copy a request in your preferred language and replace YOUR_TIMELOGIC_API_KEY with your direct API key.

    curl "https://api.timelogicapi.com/v1/time/dst?tz=Europe/Paris" \
  -H "Authorization: Bearer $TIMELOGIC_API_KEY"

    Example response

    {
  "unix": 1778093027,
  "unix_ms": 1778093027004,
  "utc": "2026-05-06T18:43:47Z",
  "iso_local": "2026-05-06T20:43:47+02:00",
  "rfc2822": "Wed, 06 May 2026 20:43:47 +0200",
  "human": "May 6, 2026, 8:43 PM Europe/Paris",
  "day_number": 4,
  "day_short": "Wed",
  "day_full": "Wednesday",
  "timezone": "Europe/Paris",
  "dst_active": true
}
    Additional endpoint notes
    https://api.timelogicapi.com/v1/time/dst?tz=Europe/Paris
https://api.timelogicapi.com/v1/time/dst?ip=8.8.8.8

    Use at most one selector family. If no selector is provided, the response defaults to UTC.

    When to use this endpoint

    Use DST status to determine whether a resolved target is currently observing daylight saving time. It is best for timezone diagnostics, support tooling, calendar UI warnings, and systems that need to explain offset changes.

    Request model

    Choose at most one selector family: tz, ip, lat + lon, or offset. If no selector is provided, the response defaults to UTC. Fixed offsets are not zones and therefore always return dst_active=false because a numeric offset has no daylight-saving rules.

    Display guidance

    Pair dst_active with timezone, iso_local, and utc when showing users why local time differs from a standard offset. This is especially helpful around spring-forward and fall-back transitions.