Timezone Date

timezone-date

By Stephen Meech

A package that uses Python scripts to offer a choice from the full set of worldwide timezones, returning the current date and time there.

time

date

timezone

python

Paste this command in a terminal to install the package

espanso install timezone-date

Description

Source

Timezone Date

A single trigger that uses two Python scripts to offer a choice from the full set of worldwide timezones, returning the current date and time there.

(Espanso's inbuilt

date

extension is handy, but very limited, especially because it can't accept a

{{variable}}

for its

offset:

value. I'll publish another small package

date-offset

to illustrate other ways in which this can be done.)

Two versions of the match file are included:

package.yml
uses the
pytz
library and should work with any version of Python
_package.yml
uses
zoneinfo
, which is part of modern editions (v3.9+) of Python, and should be a few milliseconds faster

To try the latter, rename the first file to anything you like, with an underscore

_

as its first character so that Espanso ignores it, then remove the underscore prefixing the second file's name.

In the middle of each file is a

default:

line, currently:

              default: Europe/London

Once you've tried the trigger, change this timezone value to take you quickly to a part of the list that suits you most - it's a long list!

There is scope to modify the code to:

in the last line, change the text, and date format output
hard-code a timezone into the third variable (if you only need one, for example), dispensing with the first two variables providing the choice
include some sort of time offset (do so in the final section but prior to the conversion of UTC time to the specified timezone) - see also the
date-offset
package

Stephen Meech (@smeech)

package.yml

_package.yml

# yaml-language-server: $schema=https://raw.githubusercontent.com/espanso/espanso/dev/schemas/match.schema.json

# This version should work on most versions of Python
# but may be slower than the one which uses `zoneinfo`

# Amend the `default: Europe/London` line 29 to your convenience

matches:
  - trigger: :tzdate
    replace: '{{output}}'
    vars:
      - name: zones
        type: script
        params:
          args:
            - python
            - -c
            - |
              import pytz
              print("\n".join(pytz.all_timezones))
      - name: zone_choice
        type: form
        params:
          layout: 'Pick a time-zone: [[zone]]'
          fields:
            zone:
              type: list
              values: '{{zones}}'
              default: Europe/London # Change this to a timezone that suits you
      - name: output
        type: script
        params:
          args:
            - python
            - -c
            - |
              import pytz; from datetime import datetime
              timezone = pytz.timezone('{{zone_choice.zone}}')
              # Get the current date and time in UTC
              utc_now = datetime.utcnow().replace(tzinfo=pytz.utc)
              # Convert UTC time to the specified timezone
              local_time = utc_now.astimezone(timezone)
              print("Current date and time in", timezone, "is:", local_time.strftime('%F %T'))

# yaml-language-server: $schema=https://raw.githubusercontent.com/espanso/espanso/dev/schemas/match.schema.json

# This version will work on newer (v3.9+) versions of Python
# and is probably faster than the one which relies on `pytz`

# To use it, rename this file, without the underscore `_` prefix
# and rename the other WITH an underscore prefix.

# Amend the `default: Europe/London` line 32 to suit yourself

matches:
  - trigger: :tzdate
    replace: '{{output}}'
    vars:
      - name: zones
        type: script
        params:
          args:
            - python
            - -c
            - |
              from zoneinfo import available_timezones
              print("\n".join(sorted(available_timezones())))
      - name: zone_choice
        type: form
        params:
          layout: 'Pick a time-zone: [[zone]]'
          fields:
            zone:
              type: list
              values: '{{zones}}'
              default: Europe/London # Change this to a timezone that suits you
      - name: output
        type: script
        params:
          args:
            - python
            - -c
            - |
              from datetime import datetime; from zoneinfo import ZoneInfo
              timezone = ZoneInfo('{{zone_choice.zone}}')
              # Get the current UTC time
              utc_now = datetime.utcnow()
              # Convert UTC time to the specified timezone
              local_time = utc_now.astimezone(timezone)
              print("Current date and time in", timezone, "is:", local_time.strftime('%F %T'))

Made with