# Utilities

*TOOLS/UTCOFFSET | Get UTC Offset for a Given Date

## Invocation

CALL "*tools/utcoffset",date$,outpututcoffset

Where:

date$ | The date to calculate the UTC offset for. The date format is: "YYYY-MM-DD[ HH:MM][ AM|PM]" Examples: "2023-11-30" "2023-11-30 21:00" "2023-11-30 08:00 AM" If no time is specified, the time is assumed to be the beginning of the day. If no AM/PM is specified, the time is a 24-hour format. Other date formats may be supported, but this depends on the operating system and the version of PxPlus used.
outpututcoffset | Output number where the UTC offset is returned in seconds.

## Description

Get the UTC offset for the local time zone for a given date.

(The utcoffset utility was added in PxPlus 2023.)

## Example

call "*tools/utcoffset","2024-11-30",newOffset
print "UTC offset is "+str(newOffset/60/60)+" hours."