Skip to content

Feature: Respect system timezone / add --timezone flag for date output #76

@tmad4000

Description

@tmad4000

Summary

Currently gog gmail search and other commands output dates in UTC, regardless of the user's system timezone. This makes it harder to quickly scan email timestamps.

Current behavior

$ gog gmail search "in:inbox" --json | jq '.threads[0].date'
"2026-01-14 06:37"  # UTC

Even though my system is configured for America/Los_Angeles:

$ readlink /etc/localtime
/var/db/timezone/zoneinfo/America/Los_Angeles

Proposed behavior

Either:

  1. Respect system timezone by default - Use TZ env var or system timezone for output
  2. Add --timezone flag - e.g., gog gmail search --timezone America/Los_Angeles
  3. Add --local flag - Convert output to local timezone

Use case

When quickly scanning emails in the terminal, I want to see times that match my wall clock without mental UTC conversion.

Environment

  • gog version: v0.6.0
  • macOS 15 (Sequoia)
  • System TZ: America/Los_Angeles

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions